C-LANG Statements › DEFINE Statement—Define a Logical Name for a File-System Element

DEFINE Statement—Define a Logical Name for a File-System Element

The DEFINE statement enables you to define a logical name for a file-system element such as a tape drive, spooler subsystem, and a volume.subvolume location.

Supported Job Types

This statement is optional for the HP Integrity NonStop job type.

Syntax

This statement has the following format:

DEFINE "element-name;CLASS=class;class-attribute;class-attribute..."

The CLASS=class and class-attribute operands have the following format:

{CLASS=MAP;FILE=file-name}
{CLASS=SEARCH
   [;RELSUBVOLn=subvolume-name]
   [;SUBVOLn=subvolume-name]}
{CLASS=SORT
   [;BLOCK=size]
   [;CPU=cpu-number]|[;CPUS=ALL|cpu-number,cpu-number...]
   [;MODE=AUTOMATIC|MINSPACE|MINTIME]
   [;NOTCPUS=cpu-number,cpu-number...]
   [;PRI=priority]
   [;PROGRAM=file-name]
   [;SCRATCH=file-name]
   [;SEGMENT=size]
   [;SUBSORTS=define-name,define-name...]
   [;SWAP=file-name]}
{CLASS=TAPE
   [;BLOCKLEN=length]
   [;DENSITY=800|1600|6250]
   [;RETENTION=days]
   [;SYSTEM=\node-name]
   [;TAPEMODE=STARTSTOP|STREAM]
   [;USE=IN|OUT|EXTEND|OPENFLAG]
   [;VERSION=version]
   [;VOLUME=vol-id|SCRATCH]
   [;DEVICE=device-name,device-name...]
   [;REELS=volume]
   [;EBCDIC=IN|OUT|ON|OFF]
   [;EXPIRATION=date]
   [;FILEID=file-name]
   [;FILESECT=vol1,vol2...]
   [;FILESEQ=file1,file2...]
   [;GEN=gen-num]
   [;LABELS=ANSI|IBM|OMITTED|BYPASS|BACKUP|IBMBACKUP]
   [;MOUNTMSG="message-text"]
   [;OWNER=owner-id]
   [;RECFORM=F|U]
   [;RECLEN=record-length]}

element-name

Specifies the name of the file-system element.

Limits: No less than two characters and no more than 24 characters. Case-sensitive. Must start with a letter or equal sign. After which, you can use the following characters: alphanumeric, hyphen, underscores, semicolons, and circumflex (up caret).

class

Specifies the subtype of definition being created. The classes are as follows:

MAP

Specifies a correlation between a logical device and an actual file.

SEARCH

Specifies a search list of subvolumes for a program. The SEARCH class functions similarly to the TACL #PMSEARCHLIST built-in variable.

SORT

Specifies parameters for FastSort processes and parallel SORTPROG processes.

TAPE

Used for accessing labeled tapes.

class-attribute

Specifies an attribute associated with a particular value of the class operand.

Note: The attributes are described in the SET DEFINE command, which is included in the HP NonStop TACL Reference Manual, available from HP.

Limits: You can use the following characters in the value of a class attribute: alphanumeric, hyphen, underscores, and circumflex (up caret).

Notes:

• The text string in double quotes in the DEFINE statement cannot be longer than 1024 characters.
• The DEFINE statement is case-sensitive and it can contain the delimiters comma, semicolon, and space.
• The combined length of all DEFINE statement text strings in a job cannot exceed 4096 characters minus the number of entities coded. For example, if 64 DEFINE statements are coded, the maximum length for all DEFINE data is 4096 – 64.

Example: Use the DEFINE Statement

In this example, the DEFINE statement defines logical name MYFIL1, which is used in place of the file name $DATA2.TCSDEMO.FINFOJOB.

AGENT PROAGENT
USER prod.glsys
COMMAND $C35.TCSOBJ.OABC
ENVAR STDOUT=$C35.TCSOBJ.cafout1
ENVAR STDERR=$c35.srkobj.caferr1
ASSIGN "$VOL.SUBVOL.FILE1;$VOL1.SUBVOL1.FILE2"
PARAMETER ABC(100)
DEFINE "MYFIL1;CLASS=MAP;FILE=$DATA2.TCSDEMO.FINFOJOB"