Work with Configuration Status (WRKCFGSTS)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Work with Configuration Status (WRKCFGSTS) command is used to display and to work with configuration status functions. When you run this command, the Work with Configuration Status display is shown.
For network server descriptions, the status displayed is the configuration status of the object. Options are available from Work with Configuration Status to display the status of the integrated server functions and client sessions. Use this option to check for active clients before varying off a network server description.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| CFGTYPE | Type | *NWS, *NWI, *LIN, *CTL, *DEV | Required, Positional 1 |
| CFGD | Configuration description | Generic name, name, *ALL, *CMN, *ASYNC, *BSC, *DDI, *ELAN, *FAX, *FR, *IDLC, *NET, *PPP, *SDLC, *TDLC, *TRLAN, *WLS, *X25, *WS, *LWS, *RWS, *VWS, *CRP, *DKT, *MLB, *OPTMLB, *TAPMLB, *OPT, *ASP, *NWSH, *TAP, *DSP, *LCLDSP, *RMTDSP, *VRTDSP, *PRT, *LANPRT, *LCLPRT, *RMTPRT, *VRTPRT, *LOC, *SNPT, *APPC, *FNC, *HOST, *RTL, *INTRA, *ATM, *ISDN, *T1 | Optional, Positional 2 |
| OUTPUT | Output | Optional, Positional 3 | |
| RMTLOCNAME | Remote location | Generic name, name, *NONE | Optional |
| RANGE | Range | *NET, *OBJ | Optional |
| STATUS | Status | *ALL, *ACTIVE, *FAILED, *VARYOFF, *VARYON, *AVAILABLE | Optional |
| ASTLVL | Assistance level | *PRV, *USRPRF, *BASIC, *INTERMED, *ADVANCED | Optional |
| Top |
Type (CFGTYPE)
Specifies the type of description for which you want the status to be shown.
- *NWS
- Status for network server descriptions is shown.
- *NWI
- Status for network interfaces is displayed.
- *LIN
- Status for lines is displayed.
- *CTL
- Status for controllers is displayed.
- *DEV
- Status for devices is displayed.
| Top |
Configuration description (CFGD)
Specifies the descriptions you want displayed on the Work with Configuration Status display.
- *ALL
- Status for all network interfaces, all lines, all controllers, or all devices is displayed depending on the value for the Type (CFGTYPE) parameter. Status for any attached controllers and devices is also shown.
- *CMN
- Status for communications controllers or devices is displayed depending on the value for the CFGTYPE parameter.
- *APPC
- Status for Advanced Program-to-Program Communications (APPC) controllers or devices are displayed.
- *ASP
- Status for Auxiliary storage pool (ASP) devices is displayed.
- *ASYNC
- Status for Async lines, controllers, or devices is displayed.
- *ATM
- Status for Asynchronous Transfer Mode (ATM) network interfaces is displayed.
- *BSC
- Status for Bisynchronous lines, controllers, or devices is displayed.
- *DDI
- Status for all distributed data interface lines is displayed.
- *DKT
- Status for diskette devices is displayed.
- *DSP
- Status for display devices is displayed.
- *ELAN
- Status for Ethernet lines is displayed.
- *FAX
- Status for all facsimile (fax) lines is displayed.
- *FNC
- Status for finance controllers or devices is displayed.
- *FR
- Status for all frame relay network interfaces or lines is displayed.
- *HOST
- Status for all host controllers or devices is displayed.
- *IDLC
- Status for IDLC lines is displayed.
- *INTRA
- Status for intrasystem devices are displayed.
- *ISDN
- Status for Integrated Systems Digital Network (ISDN) network interfaces are displayed.
- *LANPRT
- Status descriptions of local area network (LAN) printer devices are shown.
- *LCLDSP
- Status for local display station devices is displayed.
- *LCLPRT
- Status for local printer devices is displayed.
- *LOC
- Status for devices at a specific remote location is displayed. To specify *LOC, you must specify *DEV value for the CFGTYPE parameter.
- *LWS
- Status for local work station controllers is displayed.
- *MLB
- Status for both optical and tape media library devices is displayed.
- *NET
- Status for network lines, controllers, or devices is displayed.
- *NWSH
- Status for network server host adapter devices is displayed.
- *OPT
- Status for optical devices is displayed.
- *CRP
- Status for cryptographic devices is displayed.
- *OPTMLB
- Status for optical media library devices is displayed.
- *PPP
- Status descriptions of Point-to-Point Protocol (PPP) lines are shown.
- *PRT
- Status for all printer devices is displayed.
- *RMTDSP
- Status for remote display station devices is displayed.
- *RMTPRT
- Status for remote printer devices is displayed.
- *RTL
- Status for retail controllers or devices is displayed.
- *RWS
- Status for remote work station controllers is displayed.
- *SDLC
- Status for SDLC lines is displayed.
- *SNPT
- Status descriptions of SNA pass-through devices are shown.
- *T1
- Status for T1 network interfaces is displayed.
- *TAP
- Status for tape controllers or devices is displayed, depending on the value for the CFGTYPE parameter.
- *TAPMLB
- Status of tape media library devices is displayed.
- *TDLC
- Status for TDLC lines is displayed.
- *TRLAN
- Status for Token-ring lines is displayed.
- *VRTDSP
- Status for virtual (pass-through) display station devices is displayed.
- *VRTPRT
- Status for virtual (pass-through) printer devices is displayed.
- *VWS
- Status for virtual (pass-through) work station controllers is displayed.
- *WS
- Status for all work station controllers is displayed.
- *X25
- Status for X.25 lines is displayed. Status for all display station devices is displayed.
- generic-name
- Specify the generic name of the configuration descriptions to be displayed.
Note: A generic name is specified as a character string that contains one or more characters followed by an asterisk (*). If a generic name is specified, then all objects that have names with the same prefix as the generic object name are selected.
- name
- Specify the name of the configuration description to be displayed. Status for the specific description and any attachments is displayed.
| Top |
Output (OUTPUT)
Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
- *
- The output is displayed for interactive jobs or printed with the job's spooled output for non-interactive jobs.
- The output is printed with the job's spooled output.
| Top |
Remote location (RMTLOCNAME)
Specifies the remote location name of the devices for which you want status displayed. Only those device descriptions with the specified remote location name are listed on the Work with Configuration Status display.
This parameter is required if *LOC value is specified for the Configuration description (CFGD) parameter. It is not a valid parameter if any value other than *LOC is specified for the CFGD parameter.
- *NONE
- Status is not being displayed depending on the remote location name. *NONE should be specified if *NWI, *LIN, or *CTL value is specified for the Type (CFGTYPE) parameter. *NONE should also be specified if any value other than *LOC is specified for the CFGD parameter.
- generic-name
- Specify a generic remote location name.
Note: A generic name is specified as a character string that contains one or more characters followed by an asterisk (*). If a generic name is specified, then all objects that have names with the same prefix as the generic object name are selected.
- name
- Specify the remote location name of the devices for which you want status displayed.
| Top |
Range (RANGE)
Specifies whether downline or upline attached configuration descriptions are shown.
- *NET
- If a name for a single description is specified for the Configuration description (CFGD) parameter, both downline and upline descriptions are shown. If a special value or generic name is specified for the CFGD parameter, downline descriptions are shown.
- *OBJ
- Only objects of the type specified for the Type (CFGTYPE) parameter are shown.
| Top |
Status (STATUS)
Specifies the status values used to subset the list of descriptions shown. This parameter is ignored if a name for a single description is specified for the Configuration description (CFGD) parameter.
- *ALL
- All descriptions are included in the list regardless of their status.
- *ACTIVE
- All descriptions with an active status are shown.
- *AVAILABLE
- All descriptions with an available status are shown.
- *FAILED
- All descriptions with a failed, recovery, damaged, shutdown, or unknown status are shown.
- *VARYOFF
- All descriptions with a varied off or vary off pending status are shown.
- *VARYON
- All descriptions that do not have a varied off or vary off pending status are shown.
| Top |
Assistance level (ASTLVL)
Specifies which user interface to use.
- *PRV
- The previous user interface used is shown.
- *USRPRF
- The user interface specified for the Assistance level (ASTLVL) parameter of your user profile is used.
- *BASIC
- The Operational Assistant user interface is used.
Note: The *BASIC value is valid on the ASTLVL parameter only when *DEV value is specified for the Type (CFGTYPE) parameter.
- *INTERMED
- The system user interface is used.
- *ADVANCED
- The expert user interface is used.
| Top |
Examples
Example 1: Showing the Status for All Remote Display Stations
WRKCFGSTS CFGTYPE(*DEV) CFGD(*RMTDSP)
This command uses the Work with Configuration Status display to show the status for all remote display stations.
Example 2: Showing the Status for All Network Servers
WRKCFGSTS CFGTYPE(*NWS) CFGD(*ALL)
This command allows the user to utilize the Work with Configuration Status command to show the status for all network server descriptions on the system.
| Top |
Error messages
*ESCAPE Messages
- CPF1E99
- Unexpected error occurred.
- CPF2602
- Controller &1 not found.
- CPF2702
- Device description &1 not found.
- CPF2703
- Controller description &1 not found.
- CPF2704
- Line description &1 not found.
- CPF9846
- Error while processing file &1 in library &2.
| Top |