$E MEMBer

Function

When a member of a MAS fails (terminates without proper $PJES2 processing), JES2 does not free resources that are assigned to that member. You can request that JES2 perform this cleanup processing by issuing this command or by using the AUTOEMEM function on the MASDEF initialization statement. $E MEMBER processing (either through this command or the automatic E MEMBER processing) performs the following functions:

To cause the jobs that were being processed on the specified failed member eligible for restart on other members in the multi-access spool (MAS) configuration.
To allow remotes to sign on to other members in the MAS configuration.
To allow SPOOL command processing to complete for the specified failed member in the MAS configuration.

Syntax


>>-$E----------------------------------------------------------->

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

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

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

>--+---------------------------------------+-------------------->
   '-,--+---+--STATUS----=------MVS-GONE---'   
        '-/-'                                  

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

>--+------------------------------------+----------------------><
   '-,--+---+--VERSION--+-=--+--version-'   
        '-/-'           +-¬=-+              
                        +->--+              
                        '-<--'

Parameters

MEMBer: The member to which the entering console is attached makes the jobs being processed on the specified failed member eligible for restart on other members in the MAS configuration.
member: Specifies the 1 to 4 alphanumeric or special ($, #, or @) character name of the failed member within the MAS configuration for which job processing is restarted. You can also specify the member number (or a range, to specify more than one member), or an asterisk (*) to specify all members.
Note: Your installation determines the name of each member in the MAS configuration. The various member name used in examples throughout this publication might not be the names your installation selects.
mm: 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.
SLEVEL=slevel: Specifies that only members at the specified service level are to be reset.
STATUS= MVS-GONE: Specifies that the MVS™ system on which JES2 was running is no longer available, and you must issue $E MEMBER or by using the AUTOEMEM function on the MASDEF initialization statement to clean up any held resources.
SYSNAME=sysname: Specifies that the system name of the MVS image of the member is to be restarted. 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.
VERSION=version: Indicates the version of the JES2 release that is running on this member.

Authority Required

This command requires system 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 control security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Processing Considerations

The failed member must re-IPL. When it does, it will automatically quick start instead of warm start, resulting in significantly less JES2 initialization processing.

If your installation is participating in the AUTOEMEM option, jobs from a failed member can be restarted without this command. For information about the AUTOEMEM option, refer to the $T MASDEF command.

Note:

Jobs with member affinity to the failed system will not be restarted until the failed member is available or member affinity for those jobs is modified.
To determine the processing environment of your installation, consult your system programmer.

Note:

Scope

Single member. The values supplied for this command will be in effect for this member only.

Messages

The $HASP000 message indicates the command was accepted.

JES2 issues the $HASP493 message when initialization processing is in progress. The $HASP492 message is issued when initialization has completed.

Examples

 1   $e member(sysa)

  $HASP673 MEMBER(2) NAME=SYSA
  $HASP493 MEMBER SYSA QUICK START IS IN PROGRESS
  $HASP492 MEMBER SYSA QUICK START HAS COMPLETED

Assuming that the console on which you issue the $E command is attached to SYSC, this command causes the SYSC member to make the jobs that were being processed on SYSA (the failed member) eligible for restart on other members in the MAS configuration.

 2   $e member(1)

  $HASP003 RC=(52),MEMBER(1)  - NO SELECTABLE ENTRIES
  $HASP003         FOUND MATCHING SPECIFICATION

The member (1) specified on the command does not need to be restarted, therefore, JES2 issues the $HASP003 message.