status_dependent

The status_dependent_lu command returns information about the status of all dependent LUs on the node.

Supplied Parameters

Parameter name              Type        Length
[status_dependent_lu]
pu_name                     character    8
lu_type                     constant     ALL

Supplied parameters are:

pu_name

Name of physical unit (PU) used by the dependent LU. When you specify this parameter, status is returned for all dependent LUs that are associated with this PU.

lu_type

Specifies the type of LUs for which status is to be returned. Possible values are:

ALL: Return status for all dependent LUs.
DISPLAY: Return status for all dependent display LUs.
PRINTER: Return status for all dependent printer LUs.
RJE: Return status for all dependent LUs used for Remote Job Entry (RJE).
LU6: Return status for all dependent LUs of type 6.2.
OTHER: Return status for all dependent LUs that are not used for display, printer, RJE, or dependent LU type 6.2.

Returned Information

The following status information is returned:

Physical units (PUs) are displayed as either Inactive or SSCP, depending on whether the PU-SSCP session is active.
Each logical unit (LU) on the PU is displayed as one of the following:
Inactive
Indicates that the session between the LU and the system services control point (the LU-SSCP session) is inactive.
SSCP
Indicates that the session between the primary LU and the secondary LU (the PLU-SLU session) is inactive.
Active
Indicates that both the LU-SSCP and the PLU-SLU sessions are active.

If the node that owns the PU is a SNAplus2 version earlier than Version 5.2, the status for a dependent LU type 6.2 displays either as Inactive or Active.

If an LU is in use by an application, SNAplus2 displays additional information. Table 4-1 “Additional Information by Application Type”, shows what kind of information is displayed for a given application type.

Table 4-1 Additional Information by Application Type

Application Type Information Displayed

Unknown or LUA application

Unknown/LUA application

PU concentration Downstream LU: dslu_name

FMI application (3270)

3270 display 
user: user_name
Computer: system_name

3270 printer
user:  user_name
Computer: system_name

FMI application — RJE

RJE workstation: wkstn_name
Computer: system_name

TN3270 application

If the configured address format is dotted decimal:

TN3270 address: 1.2.3.4

otherwise:

TN3270 address: 1.2.3.4 (cfg_address)

Dependent LU 6.2

Partner LU: fqplu_name
Mode: mode_name

“Returned Information for the status_dependent_lu Command” shows an example of information returned for the status_dependent_lu command.

Returned Information for the status_dependent_lu Command

==================================================================
PU name  Lsname  NAU   LU name  LU type  Status     Description
==================================================================
PU0      TRL0                            Inactive   Link to host
                 3     LU1      DISPLAY  Inactive   Freds Display
                 4     LU2      PRINTER  Inactive   Fred's printer
                 17    DEPLU1   LU62     Inactive   Used by APP1
PU5      ETH0                            SSCP       Link for appl
                 10    LU3      RJE      Active     RJE jobs
                                         RJE workstation: WKS1
                                         Computer: george
                 11    LU4      OTHER    Inactive   Used for TN32
                 12    LU5      DISPLAY  Active     Model 5 displ
                                         3270 display user: liz
                                         Computer: george 
                 13    DEPLU2   LU62     Active     Used by APP2
                                         Partner LU: APPN.PARTNER
                                         Mode: MODE1
 PU6     DOWN                            Inactive   Downstream to
                 99    DSLU99   PRINTER  Inactive   DS for the ot
==================================================================

Status about a particular PU is obtained by including the pu_name parameter in the command. For example, SNAplus2 returns the information shown in “Returned Information for a Specified PU on the status_dependent_lu Command” if you enter:

snapadmin status_dependent_lu,pu_name=ETH0

Returned Information for a Specified PU on the status_dependent_lu Command

================================================================
PU name  Lsname  NAU   LU name  LU type Status    Description
================================================================
PU5      ETH0                           SSCP      Link for appl
                 10    LU3      RJE     Active    RJE jobs
                                        RJE workstation: WKS1
                                        Computer: george
                 11    LU4      OTHER   Inactive  Used for TN32
                 12    LU5      DISPLAY Active    Model 5 displ
                                        3270 display user: liz
                                        Computer: george 
                 13    DEPLU2   LU62    Active    Used by APP2
                                        Partner LU: APPN.PARTNER
                                        Mode: MODE1
================================================================

Status about a particular LU type is obtained by specifying the LU type in the command. You can specify any of the following values:

DISPLAY: 3270 display LU
PRINTER: 3270 printer LU
RJE: RJE workstation
LU62: Dependent LU type 6.2
OTHER: Unrestricted type

For example, SNAplus2 returns the information shown in “Returned Information for a Specified LU Type on the status_dependent_lu Command” if you enter:

snapadmin status_dependent_lu, lu_type=DISPLAY

Returned Information for a Specified LU Type on the status_dependent_lu Command

==============================================================================
PU name   Lsname   NAU  LU name  LU type  Status        Description
==============================================================================
PU0       TRL0                            Inactive      Link to host
                   3    LU1      DISPLAY  Inactive      Freds Display
PU5       ETH0                            SSCP          Link for appl
                   12   LU5      DISPLAY  Active        Model 5 displ
                                                        3270 display user: liz
                                                        Computer: george 
==============================================================================

Error Return Codes

If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.

Parameter Check

No parameter errors occur for this command.

State Check

No specific state errors, other than those listed in Appendix A “Common Return Codes from snapadmin Commands” occur for this command.

Other Conditions

Appendix A “Common Return Codes from snapadmin Commands” lists combinations of primary and secondary return codes that are common to all commands.

status_dependent_lu

Technical documentation

» Table of Contents

» Index