HPlogo MPE/iX Intrinsics Reference Manual > Chapter 5 Command Definitions (FCONTROL - FLOCK)

FINDJCW

MPE documents

Complete PDF
Table of Contents
Index

Edition 7 E0701 ♥
Edition 7 E0300
Edition 6 E0195

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:

ValueMeaning
0Successful
1Jcwname > 255 characters
2Jcwname does not start with an alpha character
3Jcwname 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, HPCIDELETEVAR, HPCIGETVAR, HPCIPUTVAR
CommandsDELETEVAR, SETJCW, SETVAR, SHOWJCW, SHOWVAR
Manuals Interprocess Communication Programmer's Guide
Command Interpreter Access and Variables Programmer's Guide
MPE/iX Commands Reference Manual




FGETKEYINFO


FINTEXIT