Common Tape System › Tape Map (TMAP)

Tape Map (TMAP)

The Tape Map (TMAP) task provides a convenient way to list the contents of an ANSI Label (AL) or Standard Label (SL) tape. It dynamically allocates one or more tape drives, and mounts the requested volumes to produce a report of the files on each AL or SL tape. The tape drive is released after the requested tapes are processed. TMAP remains active and available for more tape map requests until it is terminated by the STOP command.

Startup Procedure

TMAP can be started manually or automatically when CTS is started. Starting the TMAP subtask manually is recommended.

Automatic Startup

To automatically start the TMAP subtask each time CTS is started, add the following commands to the CTSSTART member in hlq.CTAPOPTN.

SET TASK(TMAP) PGM(CTSTMAP)
START TMAP

Manual Startup

Once the CTS task has been started, you can communicate with CTS by using a MODIFY command or by WTOR. The following is an example of how to manually start the TMAP subtask under CTS by using the MODIFY command:

F CTS,SET TASK(TMAP) PGM(CTSTMAP)
F CTS,START TMAP

TMAP Commands

Commands are sent to TMAP using the CTS Message command (MSG). The following format should be used on all commands issued to the TMAP subtask.

STOP TMAP
CANCEL TMAP
MSG TMAP,'MAP volser1,...,volsern,UNIT=uuuu'

Where:

The default is 'TAPE'.

Command

Description

STOP

To request TMAP to close all files and terminate normally.

CANCEL

To request TMAP to cancel itself with a User 111 abend.

MAP

To map the tape and report on the files it contains.

Command Sample

| F CTS,MSG TMAP,'MAP 101001,102033,534006,UNIT=3590' |

When the above command is entered, the TMAP subtask of the CTS address space will allocate a 3590 tape unit and mount the 3 volumes requested. After producing a tape map for each volume, the tape unit will be deallocated. This example assumes that the TMAP subtask has already been started, either automatically or manually.