Previous Topic: ContentsNext Topic: Task Description Reports (CREPORTs 005, 020, and 021)


Field Descriptions

A description of the fields in the sample report follows:

SYSTEM NAME and VERSION

Identifies the DC/UCF system being described.

BUILDER

Identifies the builder code for the record that defines the system occurrence. For a description of builder codes, see the Dictionary Builder Codes table at the end of this chapter.

GENERATION ID

Identifies the unique identifier for the system, as defined in the system options table at startup.

SYSTEM ID

Indicates the name (nodename) by which the DC/UCF system is known to other nodes in the DC/UCF communications network.

OPERATING SYSTEM

Identifies the name of the host operating system under which the DC/UCF system runs.

DESCRIPTION

Identifies the system description defined to the dictionary.

DATE CREATED

Identifies the date the system occurrence was added to the dictionary.

PREPARED BY

Identifies the user who added the system occurrence to the dictionary.

DATE LAST USED

Identifies the date the system occurrence was last accessed.

REVISED BY

Identifies the user who last modified the system occurrence.

STORAGE ALLOCATION

Describes the storage allocation parameters:

CWA SIZE

Identifies size, in kilobytes, of the Common Work Area (CWA).

PROGRAM POOL(K)

Identifies the amount of storage, in kilobytes, that is available for loading nonresident programs, subschemas, maps, database procedures.

STORAGE CUSHION(K)

Identifies the amount of storage, in kilobytes, that is available in the storage pool for currently executing tasks.

STORAGE POOL(K)

Identifies the amount of storage, in kilobytes, that is provided for subschema work areas, COBOL working storage sections, user variable storage, packet-data-movement buffers, and SPF work areas (SPF users only).

REENTRANT POOL(K)

Indicates the size, in kilobytes, of an optional secondary program pool reserved for reentrant programs and tables (for example, subschemas, database procedures, and IDMS DC maps).

XA PROGRAM POOL

For systems supporting 31-bit addressing, identifies the size, in kilobytes, of the 31-bit program pool.

XA STORAGE POOL

For systems supporting 31-bit addressing, identifies the size, in kilobytes, of storage pool number 255 (the 31-bit storage pool).

XA REENTRANT POOL

For systems supporting 31-bit addressing, indicates the size, in kilobytes, of the 31-bit reentrant pool.

RELOCATABLE THRESHOLD (%)

Indicates that the system should write relocatable storage to the scratch area across a pseudo-converse when the amount of space used in the storage pool reaches the indicated percentage.

RUNTIME ENVIRONMENT

Describes the runtime parameters:

MAXIMUM TASKS

Indicates the maximum number of user tasks that can be active concurrently. This number does not include external request units or the IDMS-DC system tasks. For users executing under the central version, the value includes tasks invoked by online IDD, the online subschema compiler, and CA OLQ.

SYSTEM RUN UNITS

Indicates the number of system run units initiated at startup to service:

Message dictionary requests (MSGDICT)
Queue requests (SCRATCH/QUEUE)
Signon requests (SIGNON/DEST)
Dictionary load requests (LOADER)
Security requests on system-level resources (SECURITY)
Destination requests (SYSTEM/DEST)
STORAGE PROTECTION

(IDMS DC only) Indicates whether the storage protection feature is enabled for the system.

ALTERNATE PROT KEY

(IDMS DC only) Indicates the number of the alternate storage protect key used by the IDMS DC system storage protection feature.

TICKER INTERVAL

Indicates how frequently, in wall-clock seconds, the system checks for the occurrence of timer-related events.

AUTOMATIC NEW COPY

Indicates the action taken if, in loading a program from the load area, the system finds that the program has been deleted. YES indicates that the system attempts to load the program from the system load library. NO indicates that the system does not attempt to load the program from the system load library until a DCMT VARY PROGRAM NEW COPY or an IDMS CV operator VARY SUBSCHEMA NEW COPY is issued.

UNDEFINED LOADABLE

Indicates whether SUBSCHEMAS, MAPS, TABLES, DIALOGS, and ACCESS MODULES can be automatically defined to the dictionary at run time.

PRINTED REP RET

(IDMS DC only) Identifies the amount of time, in days, that the DC system retains a report in the scratch/queue area.

PRINTER CHECKPOINT

(IDMS DC only) Identifies the page count (printer checkpoints) for all active reports. A value of 0 or OFF indicates that interrupted reports are reprinted from the beginning. Any other value indicates that printing is resumed at the last checkpoint.

RESOURCE TIMEOUT INTERVAL

(IDMS DC only) Identifies the amount of time, in wall-clock seconds, that the IDMS DC system permits a terminal to be inactive before freeing the terminal resources.

RESOURCE TIMEOUT PROGRAM/VERSION

(IDMS DC only) Identifies the name and version number of the program invoked by IDMS DC to handle the resources of an inactive terminal that has exceeded the timeout interval.

OLQ

Indicates whether the system includes CA OLQ.

ADSO

Indicates whether the system includes CA ADS.

PF KEYS

Indicates whether the system includes at least one keys table.

OLM KEYS

Indicates whether a key table is defined for OLM.

PAGE REL

Indicates whether the system invokes operating system services when one or more virtual pages are no longer required and the contents of those pages need not be saved.

LOADLIST

Identifies the default load list to be used by the system when searching for programs.

XA SCRATCH

Indicates whether or not the scratch area (DDLDCSCR) uses a 31-bit storage pool.

MULTIPLE ENCLAVE

Indicates whether the programs in this system are eligible to use the same high level Language Environment process/enclave when multiple programs are executed in the same task.

TRAN SHARING

Specifies whether to activate the Transaction Sharing option for all tasks.

INTERNAL LIMITS

Indicates whether DC/UCF controls limits on all tasks defined to the system during system generation or at run time. ENABLED indicates that limits are enforced; DISABLED indicates that limits are not enforced except by means of a DCMT VARY LIMITS command. OFF indicates that limits are not enforced.

STG LIMIT

Indicates the storage limit, in kilobytes, that a task can hold at one time.

LOCK LIMIT

Indicates the limit of record locks that a task can set.

CALL LIMIT

Indicates the limit of system service calls (for example, #GETSTG, #LOAD) a task can issue.

DBIO LIMIT

Indicates the limit of database I/O operations (for example, reads and writes) that are performed for a task.

EXTERNAL LIMITS

Indicates whether DC/UCF controls limits on all tasks associated with external request units (that is, ERUS tasks). ENABLED indicates that limits are enforced; DISABLED indicates that limits are not enforced except by means of a DCMT VARY LIMITS command. OFF indicates that limits are not enforced.

STG LIMIT

Indicates the storage limit, in kilobytes, that a task can hold at one time.

LOCK LIMIT

Indicates the limit of record locks that a task can set.

CALL LIMIT

Indicates the limit of system service calls (for example, #GETSTG, #LOAD) a task can issue.

DBIO LIMIT

Indicates the limit of database I/O operations (for example, reads and writes) that are performed for a task.

OPERATING SYSTEM INTERFACE

Describes the parameters that define how the DC/UCF system and the operating system interact.

LOG TO DATABASE

Indicates whether log records are written to the DDLDCLOG area of the dictionary.

LOGGING INFORMATION

Identifies the system log file and the maximum number of records that can be written to FILE 1, the primary file, and FILE 2, the alternate log file. If COUNT 1 is 0, a maximum number of records was not defined. If COUNT 2 is -1, an alternate log file was not defined. If COUNT 1 and COUNT 2 are both 0, log records are written to the DDLDCLOG area of the dictionary.

LOG DEVICE

(z/VSE only) Identifies the device type for the log file.

SVC NUMBER

Identifies the number of the SVC used for communication between IDMS CV and external request units.

3270 PRINT KEY

Identifies the PF key used to print screen contents.

WTO DESCRIPTION CODES

(z/OS only) Identifies the z/OS operator message codes, which are used to identify the values supplied to the DESC parameter for write-to operator (WTO) macros issued by the system.

WTO ROUTE CODES

(z/OS only) Identifies the z/OS operator message routing codes, which are used to identify values for the ROUTCDE parameter for write-to-operator (WTO) macros issued by the system.

ERROR HANDLING

Describes error handling procedures.

INACTIVE INTERVAL

(IDMS DC only) Indicates the time, in wall-clock seconds, that the system allows an internal task to wait for a resource before abnormally terminating the task.

RUNAWAY INTERVAL

Indicates the maximum time, in wall-clock seconds, that the system allows a task or transaction to execute between interval waits before abnormally terminating the task or transaction.

SYSTEM DUMP

Indicates whether the DC/UCF system takes a memory dump for all system abend codes.

SYSTEM TRACE

(IDMS DC only) Indicates whether the IDMS DC system trace facility is enabled to trace system events during program development and debugging.

TRACE ENTRIES

(IDMS DC only) Indicates the number of entries allocated to the trace table buffer.

USER TRACE

(IDMS DC only) Indicates whether the user trace facility is enabled to trace program requests for IDMS DC system services.

USERTRACE ENTRIES

Indicates the number of entries allocated to the user trace buffer.

ABRU SNAP

Indicates whether a snap dump is written to the log when an external request unit terminates abnormally.

DEADLOCK INTERVAL

Indicates the amount of time, in wall-clock seconds, that elapses before the system searches for deadlocked tasks.

SYSTEM INTERNALS

Describe the internal characteristics of the system.

ABEND STORAGE(WDS)

(IDMS DC only) Indicates the amount of storage, in fullwords, available to the IDMS DC system for processing abends.

DPE COUNT

(IDMS DC only) Indicates the number of deadlock prevention elements (DPEs) allocated to the IDMS DC system at startup.

ECB LIST(WDS)

(IDMS DC only) Indicates the size, in fullwords, of the storage allocated for the Event Control Block list.

RCE COUNT

(IDMS DC only) Indicates the number of resource control elements (RCEs) allocated to the IDMS DC system at startup.

RLE COUNT

Indicates the number of resource link elements (RLEs) allocated to the DC/UCF system at startup.

STACKSIZE (WDS)

(IDMS DC only) Indicates the size, in fullwords, of the work storage stack within the task control element (TCE) of the IDMS DC system.

PRIMARY NULL PDES

Indicates the number of null program definition elements (PDEs) allocated at system startup for the automatic definition of programs not defined in PROGRAM statements. The default 0 indicates that automatic definition is disallowed.

SECONDARY NULL PDES

Indicates the number of additional PDEs that can be allocated from the storage pool when the primary null PDEs have been used.

STATISTICS OPTIONS

Describe how system statistics are logged.

TIME INTERVAL

Indicates how frequently (in seconds) histograms and system statistics are collected.

BY TASK

Indicates whether the DC/UCF system collects CPU-time statistics for each task.

BY TRAN

Indicates whether the DC/UCF system collects statistics on a transaction-by-transaction basis for all tasks.

BY LINE

Specifies whether the DC/UCF system collects by-line histograms.

BY USER

Indicates whether the DC/UCF system collects separate by-task CPU time statistics for system-mode time and user-mode time.

COLLECT/WRITE

Indicates whether the system is collecting by-task histograms or task statistics. COLLECT (the default) indicates collection of by-task histograms; WRITE indicates collection of task statistics.

DB PARAMETERS

Describe database access, journaling, and locking parameters.

JOURNAL RETRIEVAL

Indicates whether the system is writing BGIN and ENDJ checkpoints to the journal file for retrieval transactions.

MAXIMUM SYSLOCKS

Indicates the maximum number of record that the system is to maintain for all run units at a given time.

AREA THRESHOLD

Indicates the point at which, during ready processing, the system will begin to accumulate area locks for a database transaction. OFF directs the system not to accumulate area locks until the system can acquire all areas needed by a database transaction.

AREA RETRY

Indicates the number of times the system will continue trying to gain access to all areas without accumulating area locks. FOREVER directs the system to keep trying until it acquires all areas or until operating system resource and time limits are exceeded.

RETRIEVAL LOCKING

Indicates whether the system is to maintain locks automatically for records in areas accessed in shared retrieval mode.

UPDATE LOCKING

Indicates whether the system is to maintain locks automatically for records in areas accessed in protected update mode.

SCRATCH/QUEUE JOURNAL BEFORE ONLY

Indicates whether the system performs partial journaling. NO indicates that full journaling is taking place (that is, both before and after images are being written to the journal file).

JOURNAL FRAGMENT

Indicates the maximum number of journal blocks to write to the journal file before the system writes a dummy segment (DSEG) record to the journal file. OFF indicates that the journal fragment interval is off.

JOURNAL TRANSACTION

Indicates the number of active transactions that must be running in a DC/UCF system to defer the writing of a journal block.

ON COMMIT

Specifies options that control commit behavior for all tasks in the system. Valid values are:

WRITE COMT

Writes a COMT journal record.

WRITE ENDJ

Writes an ENDJ journal record.

NEW ID

Assigns a new local transaction ID.

RETain ID

Retains the existing local transaction ID.

ON ROLLBACK

Specifies options that control rollback behavior for tasks in this system. These options apply only to rollback operations in which the transaction is continued. Valid values are:

RETAIN ID

Retains the existing local transaction ID on a rollback.

NEW ID

Assigns a new local transaction ID on a rollback.

CV PARAMETERS

Describe abend handling and time parameters for the central version.

CHKUSER TASKS

(z/OS only) Indicates the number of tasks started by the system at run time to detect abnormally terminated z/OS batch transactions. The value also represents the maximum number of batch transactions that can access the database concurrently, overriding the MAXIMUM ERUS parameter.

CVNUMBER

Indicates the number of the DC/UCF system to the CA IDMS SVC.

EXTERNAL WAIT

Indicates the time, in wall-clock seconds, that the system waits for an external request unit to issue a database request before abnormally terminating the transaction.

INTERNAL WAIT

Indicates the time, in wall-clock seconds, that the system permits an external request unit to wait for a database or system resource before abnormally terminating the transaction.

MAXIMUM ERUS

Indicates the maximum number of external request units (ERUs) that can be active concurrently.

RUPRTY

Indicates the default execution priority for all transactions.

SYSCTL PARAMETERS

Describes parameters for the system control file used by programs executing outside the system region/partition.

DDNAME

(z/OS only) Identifies the ddname of the system control (SYSCTL) file used by the system.

DBNAME

Identifies the dictionary or database to which the system will route requests from programs using the SYSCTL file.

ALWAYS/DEFAULT

Indicates which database/dictionary is accessed by programs at run time. ALWAYS indicates that programs always use the database named in the SYSCTL file regardless of IDMSOPTI or program specifications. DEFAULT indicates that programs use the database/dictionary named in the SYSCTL file only if a dictionary/database name is not specified in the IDMSOPTI module or in the program.

NODE NAME

Identifies the name of a DC/UCF system defined to DC/UCF communications network to which the system will route requests from programs using the SYSCTL file.

ALWAYS/DEFAULT

Indicates which node is accessed by programs at run time. ALWAYS indicates that programs use the node named in the SYSCTL file, regardless of the IDMSOPTI or program specifications. DEFAULT indicates that programs use the node named in the SYSCTL file only if a node is not specified in the IDMSOPTI module or in the program.