gtpo1m4lOperations

ZDSMG DEFINE-Define a Data Definition

Use this command to define a data definition name to the TPF system. You can define a data definition name for a tape device, general file data set, virtual reader, or another user-defined medium.

Requirements and Restrictions

Format




ddname
is a 1- to 16-character alphanumeric name that you want to assign to the data set.

Tape-name
is a 3-character alphanumeric tape name.

GFDS-number
is a general file data set number from 0-59.

Vrdr-spoolid
is the spool ID of a file in the virtual reader.

ALL
specifies all files in the virtual reader.

FIFO
specifies the first file in the virtual reader.

User-variable
is a 1- to 44-character alphanumeric name that identifies the user-defined medium.

If the name contains imbedded blanks or other special characters, begin and end the name with the single quotation mark (') or the dollar sign ($) character. The TPF system removes these characters from the beginning and ending name.

Additional Information

None.

Examples

The TESTDSN data definition name is defined for the OLD tape device in the following example.

+--------------------------------------------------------------------------------+
|User:   ZDSMG DEF TESTDSN TAPE-OLD                                              |
|                                                                                |
|System: DSMG0001I DDNAME TESTDSN        DEFINED                                 |
+--------------------------------------------------------------------------------+

The TESTDSN data definition name is defined for general file data set number 3 in the following example.

+--------------------------------------------------------------------------------+
|User:   ZDSMG DEF TESTDSN GFDS-3                                                |
|                                                                                |
|System: DSMG0001I DDNAME TESTDSN        DEFINED                                 |
+--------------------------------------------------------------------------------+

In the following example, the TESTDSN data definition name is defined for the virtual reader spool file that has a spool identifier of 1823.

+--------------------------------------------------------------------------------+
|User:   ZDSMG DEF TESTDSN VRDR-1823                                             |
|                                                                                |
|System: DSMG0001I DDNAME TESTDSN        DEFINED                                 |
+--------------------------------------------------------------------------------+

In the following example, the TESTDSN data definition name is defined for a user-defined medium that is identified to the TPF system as MIPC ACCESS TO SYSTEM C. Notice that this string begins and ends with the single quotation mark (').

+--------------------------------------------------------------------------------+
|User:   ZDSMG DEF TESTDSN USER-'MIPC ACCESS TO SYSTEM C'                        |
|                                                                                |
|System: DSMG0001I DDNAME TESTDSN        DEFINED                                 |
+--------------------------------------------------------------------------------+

Related Information

See TPF Database Reference for more information about general data set support.