HP 3000 Manuals HP 3000 Manuals
PUTJCW
NM and CM callable.
Assigns the value of a particular job control word (JCW) in the job
control word table.
Syntax
__________________________________________
| |
| CA U16 I16 |
| PUTJCW(jcwname,jcwvalue,jcwstatus);|
__________________________________________
Parameters
jcwname character array (required)
Passes the name of the JCW. This array can contain
up to 255 characters, beginning with a letter and
ending with a nonalphanumeric character, such as a
blank. An @ causes all executing JCWs to be set to
jcwvalue.
jcwvalue 16-bit unsigned integer by reference (required)
Passes the value of the JCW.
jcwstatus 16-bit signed integer by reference (required)
Returns the execution status:
Value Meaning
0 Successful
1 Error, jcwname greater than 255 characters
2 Error, jcwname does not start with an alpha character
3 Error, JCW table overflow (no JCW with this name
exists in table and unable to create new entry)
4 Error, jcwname cannot be a valid JCW value
5 Error, cannot assign a value to a system-reserved JCW,
or a read-only variable
6 Warning, standard variable reclassified as a JCW
7 Error, cannot reclassify predefined variable
Operation Notes
If a JCW of the same name already exists in the table, only its value is
entered. If no entry exists for this name, an entry is created and its
value is entered.
There are three types of JCWs in the system:
* User-defined
* System-defined
* System-reserved
An attempt to assign a value to a system-reserved JCW results in an
error. The system-reserved JCWs are:
* HPDATE
* HPDAY
* HPHOUR
* HPMONTH
* HPMINUTE
* HPYEAR
Related Information
Intrinsics FINDJCW, GETJCW, SETJCW
Commands SETJCW, SHOWJCW
Manuals Interprocess Communication Programmer's Guide
(32650-90019) and Command Interpreter Access and
Variables Programmer's Guide (32650-90011)