The parameter-setting clause is used to change attributes for
the LOAD
or UNLOAD
command for the
objects to be processed and to define target destinations for the
LOAD
command (for example, FNAT).
The following syntax applies to the parameter-setting clause:
WITH
|
||
(parameter-workplan) |
For an explanation of the syntax that applies to parameter-workplan, refer to Referencing Workplans in the section Workplans.
This section covers the following topics:
The syntax of the parameter-clause is shown in the following diagram. If indicated, a variable value must be supplied with a keyword.
[NAME
old-name] NEWNAME
new-name
|
||||||||||
[LIBRARY
old-library-name]
NEWLIBRARY
new-library-name
|
||||||||||
LOADFNATDBID
fnat-dbid
LOADFNATFNR
fnat-fnr[ LOADFNATNAME
vsam-name][ LOADFNATCIPHER
fnat-cipher]
|
||||||||||
fnat-password | ||||||||||
LOADFUSERDBID
fuser-dbid
LOADFUSERFNR
fuser-fnr [ LOADFUSERNAME
fuser-vsam-name][ LOADFUSERCIPHER
fuser-cipher]
|
||||||||||
fuser-password | ||||||||||
LOADNCPDBID
ncp-file-dbid
LOADNCPFNR
ncp-file-fnr [ LOADNCPNAME
ncp-file-vsam-name][ LOADNCPCIPHER
ncp-file-cipher]
|
||||||||||
ncp-file-password | ||||||||||
[FDTDBID
old-fdt-dbid
FDTFNR
old-fdt-fnr] NEWFDTDBID
new-fdt-dbid
NEWFDTFNR
new-fdt-fnr |
||||||||||
[ERRNUMDIFF
modification-of-error-message-range]
|
||||||||||
[LANGUAGE
old-language]
NEWLANGUAGE
new-language |
||||||||||
[DATE
old-date] NEWDATE
new-date |
||||||||||
[USERID
old-userid]
NEWUSERID
new-userid |
||||||||||
[TID
old-terminal-id] NEWTID
new-terminal-id |
||||||||||
[PATH
old-external-path-name] NEWPATH
new-external-path-name |
The keywords and variable values (if relevant) of the parameter-clause are explained in the following section.
Keyword | Values | Restricted to Command |
---|---|---|
NAME |
The object name to be checked if NEWNAME is specified.
|
|
NEWNAME |
A new object name.
Note: |
|
LIBRARY |
The library name to be checked if NEWLIBRARY is
specified.
|
|
NEWLIBRARY
|
A new library name. Note for the LOAD function:
|
|
LOADFNATDBID
|
The database ID (DBID) of FNAT libraries. |
LOAD |
LOADFNATFNR
|
The file number (FNR) of FNAT libraries. |
LOAD |
LOADFNATNAME
|
Only applies to objects on mainframes. |
LOAD |
LOADFNATCIPHER
|
Only applies to objects on mainframes. |
LOAD |
LOADFNATPASSWORD
or LOADFNATPSW |
Only applies to objects on mainframes. |
LOAD |
LOADFUSERDBID
|
The DBID of FUSER libraries. | LOAD |
LOADFUSERFNR
|
The FNR of FUSER libraries. | LOAD |
LOADFUSERNAME
|
Only applies to objects on mainframes. |
LOAD |
LOADFUSERCIPHER
|
Only applies to objects on mainframes. |
LOAD |
LOADFUSERPASSWORD
or LOADFUSERPSW |
Only applies to objects on mainframes. |
LOAD |
LOADNCPDBID
|
The DBID of the Adabas file for Natural command processor sources. | LOAD |
LOADNCPFNR
|
The FNR of the Adabas file for Natural command processor sources. | LOAD |
LOADNCPNAME
|
Only applies to objects on mainframes. |
LOAD |
LOADNCPCIPHER
|
The cipher code of the Adabas file for Natural command processor sources. | LOAD |
LOADNCPPASSWORD
or LOADNCPPSW |
Only applies to objects on mainframes. |
LOAD |
FDTDBID
|
The DBID of the Adabas FDT (Field Definition Table) to be checked if
NEWFDTDBID is specified.
|
|
NEWFDTDBID
|
A new DBID of the FDT. | |
FDTFNR
|
The DBID of the FDT to be checked if NEWFDTFNR is
specified.
|
|
NEWFDTFNR
|
A new FNR of the FDT. | |
ERRNUMDIFF
|
A number (positive or negative) that is to be added to the Natural error
messages during the UNLOAD or
LOAD command.
|
|
LANGUAGE
|
Up to 8 valid language codes (for example, code 1 for English)
of Natural error messages to be checked if NEWLANGUAGE (see below) is
specified.
If language contains more than one language code, new-language must contain the same numbers of language codes. Each language language code is replaced by the language code in the corresponding position of new-language. If language is not specified, new-language must not contain more than one language code. |
|
NEWLANGUAGE
|
Up to 8 valid language codes (for example, code 4 for Spanish)
for new user-defined error messages. This option does not apply to the long texts
of Natural system error messages for which English (language code 1 )
is the only valid language.
See also |
|
DATE
|
An object date.
You can add a time by inserting a blank between date and time. For the format and ranges allowed, see Date and Time in Name, Date and Time Specification. |
|
NEWDATE
|
A new object date.
|
|
USERID
|
The user ID to be checked if NEWUSERID is specified.
|
|
NEWUSERID
|
A new user ID. | |
TID
|
Only applies to objects on mainframes. |
|
NEWTID
|
Only applies to objects on mainframes. |
|
PATH
|
The path name to be checked if NEWPATH is specified.
|
|
NEWPATH
|
A new path name. |
Notes:
LOADFNAT...
,
LOADFUSER...
and LOADNCP...
are used for the
LOAD
command only, and ignored otherwise.
LOADFNAT...
is used for libraries starting with SYS
(except SYSTEM).
LOADFUSER...
is used for
libraries not starting with SYS
(but including SYSTEM).
LOADNCP...
is used for Natural command processor sources.