This statement is used to define the monitoring parameters for the COSMOS monitoring program. The mandatory events CREA, DEST, INIT, LGON, MMRC, PTSK and STAT are defined automatically. Events specified beforehand with the ADD-COSMOS-EVENT statement remain in the monitoring program definition.
The files specified with OUTPUT and ADDITIONAL-INFO=*VM2000 must already be created.
The PRIMARY-ALLOCATION value of the SPACE operand (CREATE-FILE command) must be at least twice the specified number of buffers for writing the events (NUMBER-OF-BUFFERS) when creating the COSMOS output file(s).
The SECONDARY-ALLOCATION value of the SPACE operand (CREATE-FILE command) must be set to zero when creating the COSMOS output file for WRAP-AROUND.
Format
SET-COSMOS-PARAMETERS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
TITLE =
Specifies the title of the COSMOS monitoring process.
TITLE = C'COSMOS'
Sets the title of the COSMOS monitoring process to “COSMOS”.
TITLE = <c-string 1..80>
Sets the title of the COSMOS monitoring process to the value specified here.
BUFFER-SIZE =
Specifies the number of 4K pages per buffer.
BUFFER-SIZE = 7
The buffers created have a default size of seven pages.
BUFFER-SIZE = <integer 1..40>
The buffers created have the specified number of pages.
NUMBER-OF-BUFFERS =
Specifies the number of buffers.
NUMBER-OF-BUFFERS = 32
By default, 32 buffers are created for writing events.
NUMBER-OF-BUFFERS = <integer 2..512>
COSMOS creates the specified number of buffers for writing the events.
ADDITIONAL-INFO =
Specifies the additional data to be recorded.
ADDITIONAL-INFO = *CONFIGURATION
The configuration at the start of monitoring is also recorded.
ADDITIONAL-INFO = *NONE
No additional data is 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. The files must have already been created. File link names are no longer necessary.
OUTPUT = *DISK(...)
The COSMOS monitored data is written sequentially to the files on hard disk; i.e. there is one write task for each output file. If a monitored data buffer is full, a write task is activated that writes the buffer to the appropriate 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 (this 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 = *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.
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. An asterisk * is also permitted as the last character in a wildcard specification.
CATEGORY =
The tasks are selected by means of their category.
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. An asterisk * is also permitted as the last character in a wildcard specification.
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 on the basis of their type.
TYPE = *NOT-SPECIFIED
No tasks are selected on the basis of their type.
TYPE = *SYSTEM
All system tasks are to be monitored.
TYPE = *BATCH
All batch tasks are to be monitored.
TYPE = *DIALOG
All interactive 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 = *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 = *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 = *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 = *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 = *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 = *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 = *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 = *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 = *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 = *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 = *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 = *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 = *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 = *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 = *NOT-SPECIFIED
Monitoring is terminated by the user with the STOP-MEASUREMENT-PROGRAM statement.
MEASUREMENT-TIME = <integer 1..60>
Specifies the time in minutes after which monitoring should be terminated automatically.