HPlogo 900 Series HP 3000 Computer Systems: MPE/iX Intrinsics Reference Manual > Chapter 4 Command Definitions

PUTJCW

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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:

ValueMeaning
0Successful
1Error, jcwname greater than 255 characters
2Error, jcwname does not start with an alpha character
3Error, JCW table overflow (no JCW with this name exists in table and unable to create new entry)
4Error, jcwname cannot be a valid JCW value
5Error, cannot assign a value to a system-reserved JCW, or a read-only variable
6Warning, standard variable reclassified as a JCW
7Error, 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)

Feedback to webmaster