LITERAL subcommand — assign a value to a literal

Use the LITERAL subcommand to assign a general value to a literal, which you identify with a symbol. IPCS stores the symbol and its value in the symbol table that is in a source description in your user dump directory.

If the source is a dump, IPCS does not initialize it. If the source has not been added to your user dump directory when you enter LITERAL, IPCS performs ADDDUMP processing for it, then stores the symbol and its value in the newly created source description.

Syntax

 LITERAL symbol general-value
       [ DROP | NODROP ]
       [ NOREMARK | REMARK('text') ]

-------- SETDEF-Defined Parameters -------------------------
Note: You can override the following SETDEF parameters.
See SETDEF subcommand — set defaults.

        [ ACTIVE | MAIN | STORAGE          ]
        [ DSNAME(dsname) | DATASET(dsname) ]
        [ FILE(ddname) | DDNAME(ddname)    ]
        [ PATH(path-name)     ]
        [ TEST | NOTEST ]

Parameters
symbol
Specifies the symbol that is to represent a literal. When specifying symbol, do not include the ampersand (&) or the period (.) that are normally part of symbolic notation. The symbol is 1 through 31 alphanumeric characters; the first character must be a letter or one of the following characters:
```
$  (X'5B')
#  (X'7B')
@  (X'7C')
```
general-value

Specifies the value of the literal. See General values for the types of values and for how to specify them.

DROP

NODROP
Specifies whether the created symbol can be deleted or not from the symbol table by a DROPSYM subcommand without a PURGE parameter:
- DROP specifies that the symbol can be deleted. The default is DROP.
- NODROP specifies that the symbol cannot be deleted. However, NODROP can be overridden by a PURGE parameter on the DROPSYM subcommand.
REMARK('text')

NOREMARK
Specifies or suppresses a remark associated with a symbol:
- REMARK specifies the remark. The text of the remark must be enclosed in parentheses and apostrophes.
- NOREMARK suppresses the remark.
ACTIVE or MAIN or STORAGE

DSNAME(dsname) or DATASET(dsname)

FILE(ddname) or DDNAME(ddname)

Specifies the source of the source description that is to contain the symbol. If one of these parameters is not specified, IPCS stores the symbol in the source description for your current source.
Return Codes
See Standard subcommand return codes for a description of the return codes produced by the LITERAL subcommand.
Example: Create a literal and place it in the symbol table of your current user dump directory.
- Action
```
literal data2 x'ff34a' nodrop
```
- Result
  IPCS places the literal X'FF34A' into the symbol table and identifies it the symbol DATA2.