In this final installment of the subsystem entry command article series I present the Work with Subsystem Entry (WRKSBSE) command. The WRKSBSE command allows you to select all or a subset of the subsystem descriptions found on your system. For each subsystem description the Work with Subsystem Entries list panel enables you to run any of the previously published subsystem entry commands as well as a few of the native System i subsystem commands.

As for the subsystem entry commands, to sum it all up – here's a list of the subsystem entry commands presented in this article series so far:

• Work with Routing Entries (WRKRTGE)
• Work with Job Queue Entries (WRKJOBQE)
• Work with Autostart Job Entries (WRKAJE)
• Work with Prestart Job Entries (WRKPJE)
• Work with Communication Entries (WRKCMNE)
• Work with Work Station Entries (WRKWSE)

I've included links at the end of this article to the three articles including the subsystem entry commands listed above. Now let's turn to today’s addition to the collection of subsystem entry commands, here's the WRKSBSE command prompt:

                      Work with Subsystem Entries (WRKSBSE)                    
                                                                               
 Type choices, press Enter.                                                    
                                                                               
 Subsystem  . . . . . . . . . . .   *ACTIVE       Name, generic*, *ACTIVE, *ALL
   Library  . . . . . . . . . . .                 Name, *LIBL, *CURLIB...      
 Exclude subsystem library  . . .   *NONE         Name, generic*, *NONE        
                                                                                                                                  

Specifying the default special value *ACTIVE for the Subsystem parameter causes all currently active subsystems to be listed. You also have the option of specifying the special value *ALL to include all subsystems found in the specified library, or libraries, if one of the library special values are used. A subsystem name or generic name is also supported.

The Exclude subsystem library parameter enables you to avoid including copies of system subsystem descriptions found in libraries such as QINMEDIA, QINPRIOR and QINSYS, should these be installed on your system and qualify due to the special value specified for the subsystem library parameter. Simply specify the generic name QIN* to omit the aforementioned libraries. The following list panel results from running the WRKSBSE command with default parameter setting on my system:

                          Work with Subsystem Entries                  WYNDHAMW 
                                                             30-04-10  14:15:59 
 Type options, press Enter.                                                     
   2=Change   4=Delete   5=Display   6=Routing entries   7=Job queue entries    
   8=Autostart job entries           9=Prestart job entries...                  

 Opt  Subsystem   Library     Status        Max jobs  Current active  On queue  
      QBASE       QSYS        *ACTIVE         *NOMAX            0            0  
      QBATCH      QSYS        *ACTIVE         *NOMAX           12            7  
      QCMN        QSYS        *ACTIVE         *NOMAX            7            0  
      QCTL        QSYS        *ACTIVE         *NOMAX            2            0  
      QDSNX       QGPL        *INACTIVE       *NOMAX            0      *NOTALC  
      QFNC        QGPL        *INACTIVE       *NOMAX            0      *NOTALC  
      QINTER      QSYS        *ACTIVE         *NOMAX          249            0  
      QLPINSTALL  QSYS        *INACTIVE       *NOMAX            0      *NOTALC  
      QMQM        QMQM        *ACTIVE         *NOMAX           38            0  
      QPGMR       QSYS        *ACTIVE         *NOMAX            7           12  
      QSERVER     QSYS        *ACTIVE         *NOMAX           66            0 
                                                                        More... 
 Parameters or command                                                          
 ===>                                                                           
 F3=Exit   F4=Prompt   F5=Refresh   F6=Create subsystem   F9=Retrieve           
 F11=Display text      F12=Cancel   F21=Print list        F23=More options      

Pressing function key F23 reveals the following additional list options which are also available from the list panel shown above:

   10=Start subsystem   11=End subsystem   12=Work with   14=Subsystem jobs    
   16=Communication entries   17=Work station names   18=Work station types... 

As mentioned, this makes all previously published subsystem entry commands immediately available in the Work with-list panel. To further explain the various parts of the list, I’ve included a cursor sensitive help text. Simply point the cursor to the part or column of the list that you want to learn more about and press the function key F1.

The following sources are involved in creating the WRKSBSE command:

CBX998   -- RPGLE  -- Work with Subsystem Entries - CCP              
CBX998E  -- RPGLE  -- Work with Subsystem Entries - UIM Exit Program 
CBX998H  -- PNLGRP -- Work with Subsystem Entries - Help             
CBX998P  -- PNLGRP -- Work with Subsystem Entries - Panel Group      
CBX998V  -- RPGLE  -- Work with Subsystem Entries - VCP              
CBX998X  -- CMD    -- Work with Subsystem Entries                    

CBX998M  -- CLP    -- Work with Subsystem Entries - Build command    

To create all above objects, compile and run CBX998M, following the instructions in the source header. As always, you’ll also find compilation instructions in the respective source headers.

Previously published subsystem entry commands articles from Carsten's Corner.

Carsten's Corner - New Subsystem Entry Commands – Part One

Carsten's Corner - New Subsystem Entry Commands – Part Two

Carsten's Corner - New Subsystem Entry Commands – Part Three

Click here to download all the source code for the WRKSBSE command.