Changing DSPs and modules *MODIFY,X

Function

Use the *MODIFY,X command to:

Increase or decrease the number of DSPs that can be active in the JES3 global address space.
Modify the status of the C/I, DISABLE, INTRDR, and MONITOR DSPs.
Set or reset dump suppression for all or specified JES3 failsoft codes.
Change the residency count for a module.
Change the deletion option for a module.
Load a module that is not already loaded.
Load a new copy of user exit into storage.

Syntax


>>-+-*MODIFY-+--,--X-------------------------------------------->
   '-*F------'         

>--+-,--ABEND--=--+-DM--xxxx-+--+-,--SET---+--------------------------------+-><
   |              '-ALL------'  '-,--RESET-'                                |   
   +---+-,--DSP--=-+--+-CI--+-,--HOLD---------------------------------+-+---+   
   |   '-,--D--=---'  |     +-,--MAXASST--=--xxxxxxxx--,--MC--=--nnn--+ |   |   
   |                  |     +-,--MAXJOBST--=--yyyyyyyy--,--MC--=--nnn-+ |   |   
   |                  |     +-,--MC--=--+-nnn---------------+---------+ |   |   
   |                  |     |           +-(--,--mmm--)------+         | |   |   
   |                  |     |           '-(--nnn--,--mmm--)-'         | |   |   
   |                  |     '-,--RELEASE------------------------------' |   |   
   |                  +-DISABLE--+-,--HOLD----+--,--MC--=--+-nnn-+------+   |   
   |                  |          '-,--RELEASE-'            '-NL--'      |   |   
   |                  +-dspname--,--MC--=--+-nnn-+----------------------+   |   
   |                  |                    '-NL--'                      |   |   
   |                  +-INTRDR--+-,--HOLD----+--,--MC--=--+-nnn-+-------+   |   
   |                  |         '-,--RELEASE-'            '-NL--'       |   |   
   |                  +-MONITOR--+-,--HOLD----+--,--MC--=--+-nnn-+------+   |   
   |                  |          '-,--RELEASE-'            '-NL--'      |   |   
   |                  +-POSTSCAN--,--MC--=--+-nnn---------------+-------+   |   
   |                  |                     +-(--,--mmm--)------+       |   |   
   |                  |                     '-(--nnn--,--mmm--)-'       |   |   
   |                  '-TR--,--MC--=--+-nnn-+---------------------------'   |   
   |                                  '-NL--'                               |   
   '-+-,--MODULE--=-+--+-module--+-,--RC=value---------+-+------------------'   
     '-,--M--=------'  |         +-,--REFRESH----------+ |                      
                       |         +-,--DELETE--=--+-Y-+-+ |                      
                       |         |               '-N-' | |                      
                       |         +-,--DEL--=--+-Y-+----+ |                      
                       |         |            '-N-'    | |                      
                       |         '-,--LOAD-------------' |                      
                       '-ALL--,--RC--=--value------------'

Parameters

ABEND=DMxxx | ABEND=ALL

Specifying ABEND=DMxxx selects a specific JES3 failsoft code to set or reset dump suppression. Specifying ABEND=ALL selects all JES3 failsoft codes to set or reset dump suppression.

SET

Specifies that the dump for the specified JES3 failsoft code(s) is to be suppressed.

Codes DM008 and DM133 cannot be suppressed.

RESET

Specifies that the dump for the designated JES3 failsoft code(s) is not to be suppressed.

DSP or D=CI or DISABLE or INTRDR or POSTSCAN or MONITOR

Specifies that JES3 can modify the status of the C/I, DISABLE, MONITOR, or INTRDR DSP. JES3 also can modify a C/I DSP or a POSTSCAN DSP in the JES3 global address space.

D=dspname

Use the *MODIFY,X,D=dspname command to change the number of DSPs that can be started. Processing of this command does not affect an active DSP when the command is processed. Dynamic readers are removed from the DSP chain when they complete reading the current input stream and are then limited to the new maximum count.

The dspname can be one of the following:

BDT

CBPRNT

CICLENUP

CNT

CONCMD

CONSDM

CONSERV

CONSOLES

*CR

DISABLE

DISPDJC

DISPLAY

DJCPROC

DJCUPDAT

DMJA

DSDDDR

DSI

DYNAL

ENABLE

FAILSOFT

FSIO

FSSCONT

FSTS

GENSERV

IATMSR2

INQDRVR

INQOSFCT

INTRDR

IOERR

ISDRVR

JESNEWS

JMF

JSAM

JSS

LJMF

LOCATE

MAIN

MDSCLNUP

MODDRVR

MODOSFCT

MSGC

NJE

NJECONS

NJEDUMY

NJERDR

NJEROUT

NJESF

NJESND

OUTSERV

POSTSCAN

PSODRVR

PSODSP

PURGE

READYQ

RJP

RJPSNPS

SETPR

SETUP

SNARJP

TAPDDR

TCP

TIMER

*TR

TSODRVR

TST

TST01

VARYL

VERIFY

WAIT

WTDDRVR

WTR

SAPI

SAPIDSP

WLM

GENERALP

Use the appropriate DISPLAY command to determine the maximum count for each of these DSPs.

Note: *Hot readers remain active until canceled with the *C J=XXX,KN command. If the DSP count is being lowered, enough hot readers must be canceled to bring the count to a number equal to or lower than the new count before the new count can take effect.

INTRDR

Use the *MODIFY,X,D=INTRDR command to change the number of internal reader DSPs that can be started. This does not affect internal readers active when the command is processed. They will complete the processing of the current input stream.

HOLD or RELEASE

Specifies that C/I or DISABLE DSP activity should be stopped (HOLD) or resumed (RELEASE).

The MAXASST parameter and the MAXJOBST parameter apply to the C/I DSP only.

MAXASST=xxxxxxxx

Specifies the maximum number of JCL statements that can be processed simultaneously in the JES3 global address space. The value of xxxxxxxx can be 0 to 99999999. If zero is specified, no JCL statement limit is imposed.

MAXJOBST=yyyyyyyy

Specifies the maximum number of JCL statements to be allowed in a single job. The value of yyyyyyyy can be 0 to 99999999.

MC =nnn or (,mmm) or (nnn,mmm)

Specifies the maximum number of active DSPs in the JES3 global address space for batch jobs (nnn) and started task and active TSO LOGON jobs (mmm). The total of the nnn and mmm values must not exceed 255, whether nnn and mmm are specified separately or together.

MC =nn or NL

nn specifies the maximum number of active DSPs that can be concurrently started. You specify this with the the D= parameter (nn=zero to 65534) or with the NL (no limit) parameter.

MODULE or M=module or ALL,RC=val

Specifies the number of times (2 to 32767) the ALOAD macro must load the module (or all modules) before being made resident.

DEL=Y|N or DELETE=Y|N

Changes the deletion option for the module. If DELETE=Y is specified, the module will be deleted from storage:

It has not reached its residency count (the number of times the module was loaded is less than its residency count).
The module has reached its residency count, but has not been used frequently enough.

If DELETE=N is specified, the module will remain in storage even if it has not reached its residency count or has not been used frequently enough.

REFRESH

If the module specified on the command is not a user exit, this function resets the number of times a module has been loaded and deletes the module from storage. The next load request for the module will cause a new copy to be brought into storage. If the module being refreshed is a module (CSECT) that is part of the JES3 IATNUC load module and it is eligible for refresh, a new copy of the module will be loaded at the time the REFRESH command is issued. If the module specified on the command is a user exit, the User Exit List (IATYUXL) is examined to determine if the user exit is refreshable or not. If it is refreshable, another copy of the exit is loaded into storage and the address stored into the IATYUXL. The original copy is not deleted.

The following user exits only run in the JES3 address space on the global and are refreshable:

IATUX08 (Examine Setup Information)
IATUX09 (Examine Final Job Status, JST and JVT)
IATUX17 (Define Set of Scheduler Elements)
IATUX19 (Examine/Modify Temporary OSE)
IATUX20 (Create and Write Job Headers for Job Output)
IATUX21 (Create and Write Data Set Headers for Output Data Sets)
IATUX22 (Examine/Alter the Forms Alignment)
IATUX23 (Create and Write Job Trailers for Job Output)
IATUX24 (Examine the Net Id and the Devices Requested)
IATUX27 (Examine/Alter the JDAB, JCT and JMR)
IATUX28 (Examine the JOB JCL Statement)
IATUX29 (Examine the Accounting Information)
IATUX30 (Examine Authority Level for TSO/E Terminal Commands)
IATUX33 (Modify JCL EXEC Statement and JES3 Control Statement)
IATUX34 (Modify JCL DD Statement)
IATUX35 (Validity Check Network Commands)
IATUX36 (Collect Accounting Information)
IATUX37 (Modify the JES3 Networking Data Set Header for Local Execution)
IATUX38 (Change the SYSOUT Class and Destination for a Networking Data Sets)
IATUX39 (Modify the Data Set Header for a SYSOUT Data Set)
IATUX40 (Modify Job Header for a Network Stream Containing a Job)
IATUX42 (TSO Interactive Data Transmission Facility Screening and Notification)
IATUX43 (Modify Job Header for a Network Stream Containing SYSOUT Data)
IATUX44 (Modify JCL Statements)
IATUX45 (Change Job Information for Data Sets Processed by an Output Writer FSS)
IATUX46 (Select Processors Eligible for C/I Processing)
IATUX48 (Override Operator Modification of Output Data Sets)
IATUX49 (Override the Address Space Selected for C/I Processing)
IATUX50 (JES3 Unknown BSID Modifier Exit)
IATUX60 (Determine Action to Take When a TSO User Is Unable to Receive a Data Set)
IATUX61 (Cancel Jobs Going on the MDS Error Queue)
IATUX62 (Verify a Mount Request)
IATUX66 (Determine Transmission Priority for a SNA/NJE Stream)
IATUX67 (Determine Action When Remote Data Set Is Rejected by RACF®)
IATUX68 (Modify Local NJE Job Trailers)
IATUX71 (Modify a Tape Request Setup Message)
IATUX72 (Examine/Modify a Temporary OSE or an OSE Moved to Writer Queue)

The following user exits may run both in the global and local. Only the copy of the user exit on the global may be refreshed:

IATUX18 (Command Modification and Authority Validation)
IATUX25 (Examine/Modify Volume Serial Number)
IATUX41 (Determine the Disposition of a Job that Exceeds the Job JCL Limit)

The following exits may run both in the global and a C/I FSS. Only the copy of the user exit on the global may be refreshed:

IATUX03 (Examine/Modify Converter/Interpreter Text Created from JCL)
IATUX04 (Examine the Job Information)
IATUX05 (Examine the Step Information)
IATUX06 (Examine the DD Statement Information)
IATUX07 (Examine/Substitute Unit Type and Volume Serial Information)
IATUX10 (Generate a Message)
IATUX11 (Inhibit Printing of the LOCATE Request/Response)

The following exits are NOT refreshable:

IATUX14 (Validate Fields in Spool Control Blocks During a JES3 Restart)
IATUX15 (Scan an Initialization Statement)
IATUX26 (Examine MVS™ Scheduler Control Blocks)
IATUX32 (Override the DYNALDSN Initialization Statement)
IATUX57 (Select a Single WTO Routing Code for JES3)
IATUX58 (Modify Security Information Before JES3 Security Processing)
IATUX59 (Modify Security Information After JES3 Security Processing)
IATUX63 (Provide SSI Subsystem Installation String Information)
IATUX69 (Determine if A Message is to be Sent to the JES3 Global Address Space)
IATUX70 (Perform Additional Message Processing)

LOAD

Loads a module if it is not already loaded. This is useful, for example, for loading modules before when they would normally be loaded so that traps can be set. A module that has been loaded using the LOAD function can be deleted from storage by issuing a *MODIFY,X,M= modname,REFRESH command.

Examples

Disable new internal reader activity by setting the maximum DSP count to 0:

*F,X,D=INTRDR,MC=0

Set the maximum concurrent internal readers to 5:

*F,X,D=INTRDR,MC=5

Modify the number of maximum allowable C/I DSPs in the JES3 global address space to 3 for batch jobs and 5 for started task and TSO LOGON jobs:

*F,X,D=CI,MC=(3,5)

Modify the number of maximum allowable POSTSCAN DSPs in the JES3 global address space to 1 for batch jobs and 3 for started task and TSO LOGON jobs:

*F,X,D=POSTSCAN,MC=(1,3)

Modify the global address space limit to 10000, and job JCL statement limit to 1000:

*F,X,D=CI,MAXASST=10000,MAXJOBST=1000

Stop C/I DSP activity:

*F,X,D=CI,HOLD

Resume DISABLE DSP activity:

*F,X,D=DISABLE,RELEASE

Suppress the dump for the JES3 failsoft code DM656:

*F,X,ABEND=DM656,SET

Reset dump suppression for the JES3 failsoft code ABENDDM704:

*F,X,ABEND=DM704,RESET

Reset dump suppression for all JES3 failsoft codes:

*F,X,ABEND=ALL,RESET