HPlogo MPE/iX Intrinsics Reference Manual > Chapter 9 Command Definitions (MAIL-PUTJCW)

PUTJCW

MPE documents

Complete PDF
Table of Contents
Index

Edition 7 E0701
Edition 7 E0300 ♥
Edition 6 E0195

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 Command Interpreter Access and Variables Programmer's Guide



PROCTIME

Chapter 10 Command Definitions (QUIT-ZSIZE)