HP 3000 Manuals

FINDJCW [ MPE/iX Intrinsics Reference Manual ] MPE/iX 5.0 Documentation


MPE/iX Intrinsics Reference Manual

FINDJCW 

NM and CM callable.

Searches the job control word table for a specified job control word
(JCW) and returns its value.

Syntax 
___________________________________________
|                                         |
|                CA      U16      I16     |
|     FINDJCW(jcwname,jcwvalue,jcwstatus);|
___________________________________________

            

Parameters 

jcwname               character array (required) 

                      Passes the name of the job control word (JCW) to be
                      found.  This name can contain up to 255
                      alphanumeric characters, starting with a letter and
                      delimited by a nonalphanumeric character, such as a
                      blank.

jcwvalue              16-bit unsigned integer by reference (required) 

                      Returns the value of jcwname, if jcwname is found.
                      If jcwname is not found, jcwvalue is unchanged.

jcwstatus             16-bit signed integer by reference (required) 

                      Returns the execution status of the intrinsic, as
                      follows:

                         Value    Meaning 

                           0      Successful

                           1      Jcwname > 255 characters

                           2      Jcwname does not start with an alpha character

                           3      Jcwname not found

Operation Notes 

There are three types of JCWs in the system:

   *   User-defined

   *   System-defined

   *   System-reserved

FINDJCW can return the value of any type of JCW. The system-reserved JCWs
are:

   *   HPDATE

   *   HPDAY

   *   HPHOUR

   *   HPMINUTE

   *   HPMONTH

   *   HPYEAR

Related Information 

Intrinsics            GETJCW, PUTJCW, SETJCW

Commands              SETJCW, SHOWJCW

Manuals               Interprocess Communication Programmer's Guide 
                      (32650-90019) and Command Interpreter Access and 
                      Variables Programmer's Guide (32650-90011)



MPE/iX 5.0 Documentation