$ADD REDIRect

Function

To specify redirection for commands entered at the entry console. The operator should use $ADD REDIRECT if redirection was not specified already by the initialization statement or a previous $ADD REDIRect for this console.

In a sysplex, if a JES2 subsystem has SCOPE=SYSTEM on its CONDEF initialization statement, redirection will not be in effect for that subsystem. To have that subsystem take part in the redirection, issue the $ADD REDIRect command on that JES2 subsystem.

Syntax


>>-$ADD--------------------------------------------------------->

>--REDIRect--+-entry_console--+-----------------------+-------------------+-->
             |                '- ---+-entry_console-+-'                   |   
             |                      '-*-------------'                     |   
             +-'--entry_console--'----------------------------------------+   
             |    .-,------------------------------------------------.    |   
             |    V                                                  |    |   
             '-(----+-+-entry_console-+--+-----------------------+-+-+--)-'   
                    | '-*-------------'  '- ---+-entry_console-+-' |          
                    |                          '-*-------------'   |          
                    +-entry_console--------------------------------+          
                    '-'--entry_console--'--------------------------'          

>--+--------------------+--+--------------------------+--------->
   '-,--DA--=--con_spec-'  '-,--DCONNECT--=--con_spec-'   

>--+---------------------+--+--------------------+-------------->
   '-,--DEF--=--con_spec-'  '-,--DF--=--con_spec-'   

>--+--------------------+--+------------------------+----------->
   '-,--DI--=--con_spec-'  '-,--+-DJ-+--=--con_spec-'   
                                +-DS-+                  
                                '-DT-'                  

>--+--------------------+--+-----------------------+------------>
   '-,--DN--=--con_spec-'  '-,--DNODE--=--con_spec-'   

>--+--------------------+--+----------------------+------------->
   '-,--DQ--=--con_spec-'  '-,--DSPL--=--con_spec-'   

>--+--------------------+--+------------------------+----------><
   '-,--DU--=--con_spec-'  '-,--+-LJ-+--=--con_spec-'   
                                +-LS-+                  
                                '-LT-'

Parameters

con_spec

Specifies the active MCS console at which the redirected command responses appear. If you specify only an area, the output will appear in the indicated area of the entry_console. If area is omitted, then the default area defined on the CONDEF RDIRAREA= operand will be used. This parameter is required. Con_spec may be defined as follows:

a: An output area ID
name: A 2– to 8–character symbolic console name
name-a: A symbolic console name and an output area ID

DA=con_spec

Display active jobs command.

DCONNECT=con_spec

Display network connections.

DEF=con_spec

Display JES2 parameter definitions.

DF=con_spec

Display forms queue.

DI=con_spec

Display initiators.

DJ|DS|DT=con_spec

Display job.

DN=conn_spec

Display queued jobs.

DNODE=con_spec

Display NJE nodes.

DQ=conn_spec

Display number of queued jobs.

DSPL=con_spec

Display spool volumes.

DU=con_spec

Display units.

entry_console

Specifies the 2- to 8-character console name on which an operator enters a command. If you enter any redirected commands from this console, it displays those commands that are redirected to an alternate console or area. This parameter is required and must include a console name defined during initialization. Do not specify a console area.

LJ|LS|LT=con_spec

List job output.

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 also requires of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Scope

Single member. The values supplied for this command will be in effect for this member only. There is no need to have this command issued to all members of the MAS.

Messages

The $HASP003 RC=56 message is issued if an $ADD REDIRect command is entered for a console that is already redirected.

Examples

 1   $ADD redirect(CN3EO),DNODE=CN320

  $HASP818  DA=CN3EO,DF=CN3EO,DI=CN3EO,DJ=CN3EO,DN=CN3EO,
  $HASP818  DQ=CN3EO,DU=CN3EO,DCONNECT=CN3EO,DNODE=CN320,
  $HASP818  DEF=CN3EO,DSPL=CN3EO,LJ=CN3EO

The above example causes the display response from a $D NODE command entered at console CN3EO to be automatically displayed at the console CN320.

 2    $ADD redirect(CN320),da=cn3eo-a

  $HASP818  DA=CN3EO-A,DF=CN32O,DI=CN32O,DJ=CN320,DN=CN320,
  $HASP818  DQ=CN320,DU=CN320,DCONNECT=CN320,DNODE=CN320,
  $HASP818  DEF=CN320,DSPL=CN320,LJ=CN320

The above example causes the display response from a $DA command entered on console CN320 to be automatically displayed at the console CN3EO in the out of line area A.