$D MEMBer

Function

To display information about members of a multi-access spool (MAS).

The information displayed for each member includes the member name and any of the following information:

Date and time the member was started.
Member that is restarting this member's work.
Status of the member.
Name of the MVS™ system image of the member.
Time the member last accessed the checkpoint.
Version of JES2 running on the member.

This command has parameters you can use as a filtering technique to limit the type of information to search, or the amount of information to display. See Using filtering to control and display information for additional information.

One or more parameters on this command accepts wild cards. Parameter descriptions will note that.

Syntax


>>-$D----------------------------------------------------------->

>--MEMBer--+----------------------------------------------------------+-->
           +-nn--+------------+---------------------------------------+   
           |     '- ---+-mm-+-'                                       |   
           |           '-*--'                                         |   
           +-'--member--'---------------------------------------------+   
           |    .-,----------------------------------------------.    |   
           |    V                                                |    |   
           '-(----+-+-nn-+--+------------+---------------------+-+--)-'   
                  | '-*--'  '- ---+-mm-+-'                     |          
                  |               '-*--'                       |          
                  '-+-member-------+--+----------------------+-'          
                    +-'--member--'-+  '-+- ---member-------+-'            
                    '-*------------'    +- ---'--member--'-+              
                                        '- ---*------------'              

>--+---------------------------------+-------------------------->
   '-| Selection limiting keywords |-'   

>--+-------------------------------+---------------------------><
   '-| Display limiting keywords |-'   

Display limiting keywords

|--+---------+--+------------+--+--------+---------------------->
   '-,--BOSS-'  '-,--COMMAND-'  '-,--IND-'   

>--+-------------------------------------------+--+---------+--->
   '-,--LASTART--+---------------------------+-'  '-,--NAME-'   
                 |       .-,------------.    |                  
                 |       V              |    |                  
                 '-=--(----+-STARTIME-+-+--)-'                  
                           '-STARTYPE-'                         

>--+------------+--+-----------+--+----------+--+-----------+--->
   '-,--RESETBY-'  '-,--SLEVEL-'  '-,--SMFID-'  '-,--SSNAME-'   

>--+-----------+--+------------+--+---------+--+------------+---|
   '-,--STATUS-'  '-,--SYSNAME-'  '-,--TIME-'  '-,--VERSION-'   

Selection limiting keywords

|--+---------------------------------+-------------------------->
   '-,--+---+--BOSS--+-=--+--+-No--+-'   
        '-/-'        '-^=-'  '-Yes-'     

>--+--------------------------------+--------------------------->
   '-,--+---+--IND--+-=--+--+-No--+-'   
        '-/-'       '-^=-'  '-Yes-'     

>--+------------------------------+----------------------------->
   '-,--+---+--NAME--+-=--+--name-'   
        '-/-'        +-^=-+           
                     +->--+           
                     '-<--'           

>--+----------------------------------+------------------------->
   '-,--+---+--SLEVEL--+-=--+--slevel-'   
        '-/-'          +-^=-+             
                       +->--+             
                       '-<--'             

>--+----------------------------------+------------------------->
   '-,--+---+--SSNAME--+-=--+--ssname-'   
        '-/-'          +-^=-+             
                       +->--+             
                       '-<--'             

>--+---------------------------------------------------------+-->
   '-,--+---+--STATUS--+-=--+--+-WAITING-WARMSTART-CLEANUP-+-'   
        '-/-'          '-^=-'  +-ACTIVE--------------------+     
                               +-DEFINED-------------------+     
                               +-DORMANT-------------------+     
                               +-DOWN----------------------+     
                               +-DRAINED-------------------+     
                               +-FAILED--------------------+     
                               +-INITIALIZING--------------+     
                               +-INUSE---------------------+     
                               +-JESXCF-FAILED-------------+     
                               +-JES2-FAILED---------------+     
                               +-MVS-GONE------------------+     
                               +-TERMINATED----------------+     
                               +-TERMINATING---------------+     
                               +-UNDEFINED-----------------+     
                               '-UNDEFINED-PENDING---------'     

>--+------------------------------------+----------------------->
   '-,--+---+--SYSNAME--+-=--+--sysname-'   
        '-/-'           +-^=-+              
                        +->--+              
                        '-<--'              

>--+--------------------------------+--------------------------->
   '-,--+---+--SMFID--+-=--+--smfid-'   
        '-/-'         +-^=-+            
                      +->--+            
                      '-<--'            

>--+------------------------------------+-----------------------|
   '-,--+---+--VERSION--+-=--+--version-'   
        '-/-'           +-^=-+              
                        +->--+              
                        '-<--'

Parameters

nn

The numeric value (1-32), range of values.

member

The 1 to 4 alphanumeric or special ($, #, or @) character name of the MAS member to be displayed. Specify the member number or the member name to obtain information on a specific member, or an asterisk (*) to obtain information for all members of the MAS.

You can also specify wild cards on this parameter. See Using wildcards for additional information.

BOSS[=No|Yes]

Displays the JES2 WLM representative for the MAS on this MVS image. The primary JES2 will be the BOSS if it's active and it's a part of the MAS, otherwise, the first JES2 subsystem defined for the MAS (which is active) is declared the BOSS.

COMMAND

Specifies that any commands ($P or $P XEQ) which have been issued on this member should be listed.

IND[=No|Yes]

Specifies that the independent mode status of the member is to be displayed. This is only displayed if the member is defined.

LASTART

Specifies that the type and time of the last start is to be displayed. This value is not displayed if the member has never been started.

STARTYPE

The type is one of the following:

COLD
HOT
QUICK
FORMAT
ALL-MEMBER-WARM
SINGLE-MEMBER-WARM

STARTIME

The time is GMT time, and is in the format of yyyy.ddd,hh:mm:ss.

NAME[=name]

Specifies the 1 to 4 alphanumeric or special ($, #, or @) character name of the member to be displayed.

You can also specify wild cards on this parameter. See Using wildcards for additional information.

RESETBY

Requests the identity of the member (the member number) that is performing a $E MEMBER of this member. This is only displayed while the $E MEMBER is in progress.

SLEVEL[=slevel]

Specifies that the service level number of the member is to be displayed.

SSNAME[=ssname]

Displays the subsystem name used by this member.

Specifies that the current status of the member is to be displayed. Valid keyword values for the STATUS parameter and their meanings are as follows:

ACTIVE: Displayed when the member that is up and running.
DEFINED: Displays only defined members.
Note: This parameter is only a filter. You can specify this status but DEFINED will not be displayed in the message.
DORMANT: Displayed when the member that is up and running but has not recently accessed the JES2 checkpoint.
DOWN: Displays only TERMINATED, DRAINED or FAILED members.
Note: This parameter is only a filter. You can specify this status but DOWN will not be displayed in the message.
DRAINED: Displayed when JES2 is no longer available and all work has been reset.
FAILED: Displays all members that have a status of JES2-FAILED, JESXCF-FAILED or MVS-GONE.
Note: This parameter is only a filter. You can specify this status but FAILED will not be displayed in the message.
INITIALIZING: Displayed when the member is in the process of initializing.
INUSE: Displays only ACTIVE, INITIALIZING, TERMINATING and DORMANT members.
Note: This parameter is only a filter. You can specify this status but INUSE will not be displayed in the message.
JESXCF-FAILED: Displayed when JES2 abends. Indicates that JESXCF is no longer available.
JES2-FAILED: Displayed when JES2 abends. Indicates that the address space is no longer available.
MVS-GONE: Displayed when the MVS system that JES2 was running on is no longer available and a $E MEMBER is required.
TERMINATED: Displayed after a $PJES2,TERM is issued. Specifies that JES2 is no longer available and a $E MEMBER is required.
TERMINATING: Displayed when JES2 is in the process of terminating.
UNDEFINED: Displayed when the member has not been defined through a MEMBER(n) initialization statement.
UNDEFINED-PENDING: Displayed when the member was previously defined through a MEMBER(n) initialization statement, but is in the process of having its definition deleted by another member in initialization.
WAITING-WARMSTART-CLEANUP: Display members for which warm-start processing has completed with some jobs still pending processing.

SYSNAME[=sysname]

Specifies that the system name of the MVS image of the member is to be displayed. You can also specify wild cards on this parameter. See Using wildcards for additional information.

The system name will not be displayed if it is equal to the member name (NAME=) or if the member is inactive.

SMFID[=smfid]

Specifies that the SMF ID of the MVS image of the member is to be displayed. You can also specify wild cards on this parameter. See Using wildcards for additional information.

The SMF IDwill not be displayed if it is equal to the member name (NAME=) or if the member is inactive.

TIME

Displays the last time (in GMT time) the member accessed the checkpoint. This is not displayed if the member is inactive or undefined.

VERSION[=version]

Indicates the version of the JES2 release that is running on this member.

Authority Required

This command requires display authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS system command group is assigned.

This command requires read security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Scope

MAS-wide. The response to this command will be a display of information about the requested member(s) only.

Messages

The $HASP673 message is issued in response to this command.

Examples

 1   $D MEMBER(2)

  $HASP673 MEMBER(2)   NAME=IBM2,STATUS=ACTIVE,IND=NO,
  $HASP673             LASTART=(ALL-MEMBER-WARM,(1997.134,
  $HASP673             12:54:30)),SYSNAME=SY1,
  $HASP673             TIME=(1997.136,19:08:00.77),
  $HASP673             VERSION=OS 2.4.0,SLEVEL=0,SSNAME=JES2,
  $HASP673             BOSS=YES

This command displays information about MAS member 2.

 2   $D MEMBER(*), ind=no

  $HASP673           MEMBER(1)   NAME=PSU2,STATUS=DRAINED,IND=NO
  $HASP673 MEMBER(2)   NAME=IBM2,STATUS=ACTIVE,IND=NO,
  $HASP673             LASTART=(ALL-MEMBER-WARM,(1994.235,
  $HASP673             20:31:38)),SYSNAME=SY1,
  $HASP673             TIME=(1994.235,20:32:02.41),
  $HASP673             VERSION=SP 5.2.0
            $HASP673 MEMBER(3)   NAME=NIH2,STATUS=DRAINED,IND=NO
            $HASP673 MEMBER(4)   NAME=BCG2,STATUS=DRAINED,IND=NO
            $HASP673 MEMBER(5)   NAME=WFB2,STATUS=DRAINED,IND=NO
            $HASP673 MEMBER(6)   NAME=SY06,STATUS=DRAINED,IND=NO
            $HASP673 MEMBER(7)   NAME=SY07,STATUS=DRAINED,IND=NO
            $HASP673 MEMBER(8)   NAME=SY08,STATUS=DRAINED,IND=NO
⋮

This command displays information about all members not in independent mode.