gtps4m2zSystem Generation

LOGCAP

The LOGCAP macro is used to specify information relating to LOG/XCP processing. Values are entered to specify the online module ranges to be assigned to each of the LOG/XCP exception recording tapes. LOGCAP is required if the capture/restore facility is desired. Detailed explanations of how to initialize these fields are available in "File Capture and Restore" in the TPF Database Reference.

LOGCAP is required if the capture/restore facility is desired.

Format




Note:
Parameters RTT, RTU, RTV, RTW, RTX and RTY are identical in definition of contents. Therefore only one definition is provided.

At least one of these parameters must be defined. It does not matter which one is supplied.

RTa
Where a = T, U, V, W, X or Y, the tape name.

ds
The starting DASD device type for the tape. DEVA for device A, DEVB for device B, DEVC for device C, or DEVD for device D. (See the ONLFIL macro.)

ms
The starting relative module number within the starting device type (i.e., 0 is the first relative module number, the number of modules minus one is the last module number).

de
The ending DASD device type for the tape (refer to ds for parameter definition).

me
The ending relative module number within the ending device type (refer to ms for parameter definition).

This range defines the valid disk low and high contiguous module numbers assigned to this tape for LOG/XCP capture/restore.

Tapes must cover all disk module numbers on the system without overlaps. For example, a system with 4 device A and 2 device B modules might be assigned:

RTV = (DEVA,0,DEVA,1)
RTU = (DEVA,2,DEVA,3)
RTY = (DEVB,0,DEVB,0)
RTW = (DEVB,1,DEVB,1)
Note:
The starting (ms) and ending (me) ranges will be cross-checked against the inputs provided to the ONLFIL macro. If the logging ranges exceed the module ranges defined by ONLFIL, then an error or warning message is issued. The module ranges cannot exceed the maximum number allowed, 3998, regardless.

STAMP=15|n
Time interval, in minutes, at which a time stamp will be written to all logging tapes. Zero is not valid.

Examples

LOG/XCP recording is to be done to tape name RTV for device A. This device has two modules. All other values can default. Code the LOGCAP macro as follows:

LOGCAP  RTV=(DEVA,0,DEVA,1)

Possible errors in assigning disk modules with the same system might be:

RTT = (DEVA,1,DEVA,3)
RTY = (DEVB,0,DEVB,1) all modules not included

or,

RTY = (DEVA,0,DEVA,2)   RTY and RTW overlap.  They both attempt
RTW = (DEVA,2,DEVA,3)   to map DEVA 2.
RTY = (DEVB,0,DEVB,1)

References

None.