ADD-USER / MODIFY-USER-ATTRIBUTES command
System administration uses the ADD-USER command to define which test privilege a user is to be granted, see the manual “Commands” [8]:
ADD-USER TEST-OPTIONS=*PARAMETERS(READ-PRIVILEGE=...,MODIFICATION=...).
User-specific test privileges can be modified with the MODIFY-USER-ATTRIBUTES command.
You can display the current settings for privileges on a user-specific basis using the SHOW-USER- ATTRIBUTES command, TEST-OPTIONS operand (and on a taskspecific basis using the SHOW-TEST-OPTIONS command, INFORMATION= *PRIVILEGE operand).
MODIFY-TEST-OPTIONS command
The user can employ the MODIFY-TEST-OPTIONS command to specify task-specific settings for test and diagnostics.
DUMP operand
The DUMP operand of the MODIFY-TEST-OPTIONS command is used to determine how the user dump generated with CDUMP is to be handled after the message IDA0N51 PROGRAM INTERRUPT AT LOCATION ... is issued. It is also used to indicate whether a user or area dump is to be converted to a system dump.
You can display the current settings for outputting user and area dumps using the SHOW-TEST-OPTIONS command, INFORMATION=USERDUMP-OPTIONS operand.
DUMP=*STD (interactive mode)
CDUMP issues the following message:
IDA0N45 DUMP DESIRED? REPLY (Y=USER-/AREADUMP TO DISK; Y,<VOLUMETYPE>=USER-/AREADUMP TO TAPE; Y,SYSTEM=SYSTEMDUMP TO DISK; N=NO)
If the user responds with “N”, the dump is suppressed. If the user responds with “Y” or “Y,SYSTEM”, CDUMP generates the dump and issues the message:IDA0N53 DUMP BEING PROCESSED. PLEASE HOLD ONIf the user has a read test privilege >= 3 and responds with “Y,SYSTEM”, a user or area dump is converted into a system dump.If <VOLUMETYPE> is specified, the dump is written to tape.
Message IDA0N53 is suppressed if CDUMP is called with the command CANCEL-JOB DUMP= (see the CANCEL-JOB command below).
DUMP=*STD (in batch mode and in procedures)
Output of the dump is suppressed and the following message is issued:IDA0N48 TASK/SYSTEM SETTINGS PROHIBIT DUMP
DUMP=*YES
The user and area dumps are generated and the following message output to SYSOUT: IDA0N53 DUMP BEING PROCESSED. PLEASE HOLD ON
Message IDA0N45 is suppressed.
DUMP=*NO
Generation of user and area dumps is suppressed and the following message is output to SYSOUT instead of message IDA0N45:IDA0N47 DUMP PROHIBITED BY /MODIFY-TEST-OPTIONS COMMAND
DUMP=*SYSTEM
A user or area dump is converted to a system dump if the user possesses a read test privilege >= 3.
The message IDA0N45 is suppressed.
DUMP-CONTENTS operand
The DUMP-CONTENTS operand of the MODIFY-TEST-OPTIONS command can be used to control inclusion of DIV windows, data spaces and POSIX MMAP areas in the user dump. The DUMP operand must not be set to *NO or *SYSTEM if this control is desired.
DUMP-CONTENTS=*PARAMETERS(DATA-IN-VIRTUAL=*NO/*STD/*YES)
If the operand value is set to *NO, no page of the DIV area is included in the user dump. The *STD and *YES operand values have the same meaning and cause the inclusion of DIV windows in the user dump.
DUMP-CONTENTS=*PARAMETERS(DATA-SPACES=*STD/*YES/*NO)
If the operand value is set to *NO, no page of the DS area is included in the user dump. The *STD and *YES operand values have the same meaning and cause the inclusion of data spaces in the user dump.
DUMP-CONTENTS=*PARAMETERS(MEMORY-MAP=*STD/*YES/*NO)
The value *STD or *YES causes POSIX pages to be included in the user dump; the value *NO means that no page of the MMAP area will be included in the user dump.
TSN operand
The TASK-ID operand can be used to specify the task for which the dump output settings are to be changed.
TSN=*OWN
The changes to the dump output settings apply to the user’s own task.
TSN=<alphanum-name 1..4>/ <c-string 1..4>
The changes to the dump output settings apply to the task with the specified TSN. Users who have not been assigned the TSOS privilege may only modify the settings of tasks running under their own user ID.
OUTPUT-PUBSET operand
The OUTPUT-PUBSET operand is used to specify the pubset to which user dumps or area dumps are saved.
OUTPUT-PUBSET=*DEFAULT-PUBSET
A user dump or area dump is saved to the default pubset defined for the user ID of the task causing the dump, provided the dump does not contain data deserving special protection. Otherwise, the dump is saved to the default pubset of the SYSUSER user ID.
OUTPUT-PUBSET=<cat-id 1..4>
A user dump or area dump is saved to the specified pubset.
If the dump cannot be saved to the specified pubset (e.g. because insufficient space is available), it is saved to the default pubset.
MAXIMUM-NUMBER operand
The MAXIMUM-NUMBER operand can be used to set a maximum value for the number of user and area dumps to be created.
MAXIMUM-NUMBER=*UNLIMITED
There is no upper limit on the number of user dumps and area dumps.
MAXIMUM-NUMBER=<integer 1..255>
The number of user dumps and area dumps is limited to the value specified here.
SUPPRESS-DUPLICATES=*NO/*YES operand
The SUPPRESS-DUPLICATES operand is used to specify whether a user dump or area dump should be suppressed if it is a duplicate of a dump that has already been generated. A dump is considered to be a duplicate if it occurs at the same location in the same program and has the same interrupt weight as another dump.
PRIVILEGE operand
The operand PRIVILEGE = *PAR(READ=...) is used to set read task specific read test privileges.
Users without privileges can only request a system dump if they have a read privilege >= 3 (see the ADD-USER command).
CANCEL-JOB command
The CANCEL-JOB command cancels a job. The DUMP operand determines whether a dump should be generated for the job being canceled or whether a user dump or area dump currently in progress should be aborted.
DUMP operand
The DUMP operand defines whether a dump is to be output for the job which is to be canceled.
DUMP = *NO
A dump is not requested. If, however, a dump is already in progress for the job being canceled, it is completed in full.
DUMP = *STD
If the operand DUMP=*YES or DUMP=*STD was set with the MODIFY-TEST-OPTIONS command, a dump is generated (even if *STD would imply a *NO, which is the case in batch or procedure mode). No dump occurs if DUMP=*NO is explicitly specified. If DUMP=*SYSTEM is specified a system dump is generated.
DUMP = *CANCEL-RUNNING-DUMP
If a user dump or area dump is already in progress for the job that is to be canceled, the dump is aborted immediately and the dump file is deleted.
MODIFY-SYSTEM-PARAMETERS command
The MODIFY-SYSTEM-PARAMETERS command can be used by the system administrator to set the CDUMP system parameters.