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 network server functions and client sessions. Use this option to check for active clients before varying off a network server.

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 *, *PRINT 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 servers 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, 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.

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.

*PRINT

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.

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.

The *BASIC value for 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 servers 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