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.