Changing console information *MODIFY,O

Function

Use the *MODIFY,O command to:
  • Activate or deactivate DLOG
  • Add or delete JES3 destination class(es) or routing code(s) for a particular remote console.
  • Change the JES3 authority level for a remote console.
  • Activate or deactivate the saving of messages for a remote console when the workstation is not signed on.

If RACF® command checking is not enabled, you can alter a console's authority level after initialization by issuing a *MODIFY,O command. If RACF command checking is enabled and you issue the *MODIFY,O command to change a console's authority level, the JES3 authority level of the console will be altered, but command authorization will not be affected if you are using RACF for command authorization. See z/OS JES3 Initialization and Tuning Guide for more information about assigning authority levels when using RACF. Use the *INQUIRY,O command to display a console's current authority level. You can use JES3 installation exit IATUX18 to redefine authority levels in specific cases. See z/OS JES3 Customization for information about IATUX18.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-+-*MODIFY-+-------------------------------------------------->
   '-*F------'   

>--+-,--O----,--DLOG--=--+-ON--+-----------------------+-------><
   |                     '-OFF-'                       |   
   '-,--O--=--con--+-,--A--=--auth-------------------+-'   
                   +-,--ADEST--=--+-dest-----------+-+     
                   |              |    .-,----.    | |     
                   |              |    V      |    | |     
                   |              '-(----dest-+--)-' |     
                   +-,--DDEST--=--+-dest-----------+-+     
                   |              |    .-,----.    | |     
                   |              |    V      |    | |     
                   |              '-(----dest-+--)-' |     
                   +-,--AROUT--=--+-rout-----------+-+     
                   |              |    .-,----.    | |     
                   |              |    V      |    | |     
                   |              +-(----rout-+--)-+ |     
                   |              |    .-,----.    | |     
                   |              |    V      |    | |     
                   |              '-(----rout-+--)-' |     
                   +-,--DROUT--=--+-rout-----------+-+     
                   |              |    .-,----.    | |     
                   |              |    V      |    | |     
                   |              +-(----rout-+--)-+ |     
                   |              '-(--rout--)-----' |     
                   '-,--SAVEMSG--=--+-YES-+----------'     
                                    '-NO--'                

Parameters

DLOG= ON / OFF
Specifies whether the JES3 DLOG should be activated or deactivated.
ON
Specifies that you want JES3 to write a system log for the sysplex to a spool data set for subsequent processing by output service. The log is written in JES3 format from the global processor.
OFF
Specifies that JES3 is not to maintain the system log for the sysplex. In this case, the hardcopy log will be written to OPERLOG or SYSLOG as specified in the CONSOLxx HARDCOPY statement for each system.
A=auth
Specifies the level of authority (0 through 15) for the selected JES3 RJP console. After you set a console's authority level below ten, you cannot change that console's authority from that console. You can change it by entering the *MODIFY,O command at another console whose authority level is ten or above.
ADEST=dest
Specifies the JES3 destination class that you want to add to the designated RJP console.
DDEST=dest
Specifies the JES3 destination class that you want to delete from the designated RJP console. JES3 no longer displays messages that are associated with that destination class.
AROUT=rout
Specifies the routing code that you want to add to the specified console.
DROUT=rout
Specifies the routing code that you want to delete from the specified console.
SAVEMSG = YES / NO
Indicates whether JES3 should save messages destined for the specified RJP console when it is not signed on. For SAVEMSG=YES, messages for the specified remote console will be saved on spool and sent to the remote console once it signs on. For SAVEMSG=NO, messages for the specified console will not be saved while the console is not signed on.

Examples

Change the authority level of console RMT01 from 15 to 4:
*F,O=RMT01,A=4
Restrict console RMT01 from being able to bring down JES3:
*F,O=RMT01,A=11
Direct error messages to console RMT02, by adding the error destination class (ERR) to any classes already assigned to console RMT02:
*F,O=RMT02,ADEST=ERR
Direct messages with routing code 7 and 9 to console RMT02, by adding the routing codes to list of routing codes being received:
*F,O=RMT02,AROUT=(7,9)
Stop the display of messages that pertain to RJP teleprocessing equipment on console RMT03.
*F,O=RMT03,DDEST=TP