This statement is used to modify the COSMOS monitoring program definition.
It is useful when the SHOW-DEFINED-PARAMETERS statement finds parameters that have to be modified.
Format
MODIFY-COSMOS-PARAMETERS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
TITLE =
Specifies the title of the COSMOS monitoring process.
TITLE = *UNCHANGED
The currently specified title is not changed.
TITLE = <c-string 1..80>
The specified title is assigned.
BUFFER-SIZE =
Specifies the number of 4K pages per buffer.
BUFFER-SIZE = *UNCHANGED
The currently specified number of pages per buffer is not changed.
BUFFER-SIZE = <integer 1..40>
Buffers of the specified size (number of pages) are created.
NUMBER-OF-BUFFERS =
Specifies the number of buffers.
NUMBER-OF-BUFFERS = *UNCHANGED
The currently specified number of buffers is not changed.
NUMBER-OF-BUFFERS = <integer 2..512>
COSMOS creates the specified number of buffers for writing events.
ADDITIONAL-INFO =
Specifies additional data to be recorded.
ADDITIONAL-INFO = *UNCHANGED
The existing data specified for ADDITIONAL-INFO is not changed.
ADDITIONAL-INFO = *NONE
No additional data is recorded.
ADDITIONAL-INFO = *CONFIGURATION
The configuration at the start of monitoring is also recorded.
ADDITIONAL-INFO = *VM2000(...)
The VM2000 events are also recorded. For this purpose, they must be explicitly opened (ADD-COSMOS-EVENT statement).
FILE-NAME = <filename 1..54 without-gen-vers>
Specifies the name of the file to which the VM2000 events are written.
OUTPUT =
Specifies how the COSMOS output files are written.
OUTPUT = *UNCHANGED
The currently specified value for OUTPUT is not changed.
OUTPUT = *DISK(...)
The COSMOS monitoring data is written sequentially to the files on hard disk; i.e. there is a write task for each output file. If a monitoring data buffer is full, a write task is activated that writes the buffer to the corresponding file.
FILE-NAME = list-poss(16): <filename 1..54 without-gen-vers>
Specifies the file(s) to which the COSMOS monitored data is written.
OUTPUT = *WRAP-AROUND(...)
COSMOS monitored data is written to a file on disk. If the disk space allocated (PRIMARY-ALLOCATION) is insufficient, the file is overwritten from the top. The secondary allocation (SECONDARY-ALLOCATION) must be set to zero.
FILE-NAME = <filename 1..54 without-gen-vers>
Specifies the file to which COSMOS monitored data is written.
OUTPUT = *TAPE(...)
The COSMOS monitored data is written sequentially to the files on tape (works as described for OUTPUT=*DISK.)
FILE-NAME = list-poss(16): <filename 1..54 without-gen-vers>
Specifies the file(s) to which COSMOS monitored data is written.
OUTPUT = *STREAM-TAPE(...)
The COSMOS output files are written in streaming mode. This reduces the chances of events not being recorded, because the files are written to the tape continuously without any repositioning of the tape.
FILE-NAME = list-poss(16): <filename 1..54 without-gen-vers>
Specifies the file(s) to which COSMOS monitored data is written.
TASK-SELECTION =
Specifies the tasks to be monitored.
TASK-SELECTION = *UNCHANGED
The current selection of tasks to be monitored is not changed.
TASK-SELECTION = *ALL
All tasks are monitored.
TASK-SELECTION = *SPECIFIED(...)
Specifies the tasks to be monitored by means of their TSN, user ID, job name, category or type.
JOB-NAME =
The tasks are selected by means of their job name. An asterisk * is also permitted as the last character in a wildcard specification.
JOB-NAME = *NOT-SPECIFIED
No tasks are selected by means of their job name.
JOB-NAME = list-poss(8): <alphanum-name 1..8 with-wild>Specifies the job names of the tasks to be monitored.
CATEGORY =
The tasks are selected by means of their category. An asterisk * is also permitted as the last character in a wildcard specification.
CATEGORY = *NOT-SPECIFIED
No tasks are selected by means of their category.
CATEGORY = list-poss(8): <alphanum-name 1..7 with-wild>
Specifies the categories of the tasks to be monitored.
USER-ID =
The tasks are selected by means of their user ID.
USER-ID = *NOT-SPECIFIED
No tasks are selected by means of their user ID.
USER-ID = list-poss(8): <alphanum-name 1..8 with-wild>
Specifies the user IDs of the tasks to be monitored. These must be specified without the $ sign. An asterisk * is also permitted as the last character in a wildcard specification.
TSN =
The tasks are selected by means of their TSN.
TSN = *NOT-SPECIFIED
No tasks are selected by means of their TSN.
TSN = list-poss(16): <alphanum-name 1..4 with-wild>
Specifies the TSNs of the tasks to be monitored. An asterisk * is also permitted as the last character in a wildcard specification.
TYPE =
The tasks are selected by means of their type.
TYPE = *NOT-SPECIFIED
No tasks are selected by means of their type.
TYPE = *SYSTEM
All system tasks are to be monitored.
TYPE = *DIALOG
All interactive tasks are to be monitored.
TYPE = *BATCH
All batch tasks are to be monitored.
TYPE = *TP
All TP tasks are to be monitored.
EVENT-SELECTION =
Specifies the events to be recorded. Their recording is linked to specific conditions.
EVENT-SELECTION = *UNCHANGED
The existing values for EVENT-SELECTION are not changed.
EVENT-SELECTION = *ALL-BY-ADD-COSMOS-EVENT
All open events are recorded.
EVENT-SELECTION = *SPECIFIED(...)
Only those events that satisfy the specified conditions are recorded.
EIA-INTERRUPT-CLASS =
Controls the recording of EIA events on the basis of their interrupt class (IC).
EIA-INTERRUPT-CLASS = *UNCHANGED
The currently specified ICs are not changed.
EIA-INTERRUPT-CLASS = *ANY
The recording of EIA events is independent of their IC.
EIA-INTERRUPT-CLASS = list-poss(5): *SVC / *PROGRAM / *MACHINE-CHECK / *IO / *EXTERNAL
Only those EIA events with the specified IC are recorded.
EIA-SVC-NUMBER =
Controls the recording of EIA events on the basis of their SVC.
EIA-SVC-NUMBER = *UNCHANGED
The currently specified SVCs are not changed.
EIA-SVC-NUMBER = *ANY
The recording of EIA events is independent of their SVC.
EIA-SVC-NUMBER = list-poss(8): <integer 1..255>
Only those EIA events with the specified SVC(s) are recorded.
IO-DEVICE =
Controls the recording of SDV, CHTM, IONQ and PMIO events on the basis of their mnemonic device name.
IO-DEVICE = *UNCHANGED
The currently specified mnemonic device names are not changed.
IO-DEVICE = *ANY
The recording of SDV, CHTM, IONQ and PMIO events is independent of their mnemonic device name.
IO-DEVICE = list-poss(8): <alphanum-name 2..4>
Only those SDV, CHTM, IONQ and PMIO events with the specified mnemonic device names are recorded.
DAB-CACHE-ID =
Controls the recording of DAB events on the basis of their DAB cache IDs.
DAB-CACHE-ID = *UNCHANGED
The currently specified DAB cache IDs are not changed.
DAB-CACHE-ID = *ANY
The recording of DAB events is independent of their DAB cache IDs.
DAB-CACHE-ID = list-poss(8): <alphanum-name 1..32>
Only those DAB events with the specified DAB cache IDs are recorded.
MEMORY-CLASS =
Controls the recording of RELM and REQM events on the basis of their memory class.
MEMORY-CLASS = *UNCHANGED
The currently specified memory classes for RELM and REQM events are not changed.
MEMORY-CLASS = *ANY
The recording of RELM and REQM events is independent of their memory class.
MEMORY-CLASS = list-poss(4): *3 / *4 / *5 / *6
Only those RELM and REQM events with the specified memory classes are recorded.
SLOT-MEMORY-CLASS =
Controls the recording of SLOT events on the basis of their memory class.
SLOT-MEMORY-CLASS = *UNCHANGED
The currently specified memory classes for SLOT events are not changed.
SLOT-MEMORY-CLASS = *ANY
The recording of SLOT events is independent of their memory class.
SLOT-MEMORY-CLASS = list-poss(4): *3 / *4 / *5 / *6
Only those SLOT events with the specified memory classes are recorded.
PEND-CODE =
Controls the recording of PEND events on the basis of their pend code.
PEND-CODE = *UNCHANGED
The currently specified pend codes are not changed.
PEND-CODE = *ANY
The recording of PEND events is independent of their pend code.
PEND-CODE = list-poss(16): <integer 1..22>
Only those PEND events with the specified pend code are recorded.
LOCK-ID =
Controls the recording of LOCK events on the basis of their lock ID.
LOCK-ID = *UNCHANGED
The currently specified lock IDs are not changed.
LOCK-ID = *ANY
The recording of LOCK events is independent of their lock ID.
LOCK-ID = list-poss(4): <alphanum-name 1..2>
Only those LOCK events with the specified lock IDs are recorded.
TLT-DESCRIPTOR =
Controls the recording of TLT on the basis of their TLT descriptor (TLT = Task Location Table).
TLT-DESCRIPTOR = *UNCHANGED
The currently specified values for the TLT descriptor are not changed.
TLT-DESCRIPTOR = *ANY
The recording of TLT events is independent of their TLT descriptor.
TLT-DESCRIPTOR = list-poss(8): <alphanum-name 1..3>
Only those TLT events with the specified TLT descriptors are recorded.
TSKI-SWITCH =
Controls the recording of TSKI events on the basis of their TIC (Task in Control).
TSKI-SWITCH = *UNCHANGED
The currently specified value for TSKI-SWITCH is not changed.
TSKI-SWITCH = *ANY
The recording of TSKI events is independent of their TIC.
TSKI-SWITCH = *TASK
Only the first TSKI event of a TIC is recorded.
TSVC-SVC-NUMBER =
Controls the recording of TSVC events on the basis of their SVC numbers.
TSVC-SVC-NUMBER = *UNCHANGED
The currently specified SVC numbers are not changed.
TSVC-SVC-NUMBER = *ANY
The recording of TSVC events is independent of their SVC number.
TSVC-SVC-NUMBER = list-poss(8): <integer 1..255>
The TSVC events are recorded for the specified SVC numbers.
CPU-NUMBER =
Controls the recording of events according to the CPU number.
CPU-NUMBER = *UNCHANGED
The currently specified CPU numbers are not changed.
CPU-NUMBER = *ANY
The recording of events is independent of their CPU number.
CPU-NUMBER = list-poss(32): <integer 0..31>
Only the events for the specified CPU numbers are recorded.
UNLOAD =
Specifies the time at which the COSMOS subsystem is to be unloaded.
UNLOAD = *UNCHANGED
The currently specified value is not changed.
UNLOAD = *AT-MEASUREMENT-PROGRAM-STOP
The COSMOS subsystem is unloaded at the end of COSMOS monitoring.
UNLOAD = *AT-SM2-STOP
The COSMOS subsystem is unloaded at the end of SM2 monitoring.
MEASUREMENT-TIME =
Specifies the duration of the monitoring process.
MEASUREMENT-TIME = *UNCHANGED
The currently specified duration is not changed.
MEASUREMENT-TIME = *NOT-SPECIFIED
Monitoring is terminated by the user with the STOP-MEASUREMENT-PROGRAM TYPE = *COSMOS statement.
MEASUREMENT-TIME = <integer 1..60>
Specifies the time in minutes after which monitoring is to be terminated automatically.