HPlogo MPE/iX Commands Reference Manual: HP 3000 MPE/iX Computer Systems

Appendix A Predefined Variables in MPE/iX

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Many variables have been predefined for use by the command interpreter. They may be used anywhere you would use your own variables. Table A-1 “Predefined Variables” lists all valid predefined variables.

Table A-1 Predefined Variables

VariableType[1]DefinitionInitial Value
CIERRORW JCWlast CI error numberzero
HPACCOUNTR Suser's account namelogon account
HPACCTCAPR Icurrent account capability masklogon account caps
HPACCTCAPFR Scurrent account formatted capability mask, for example, "AM, AL, GL, ND, SF, BA, IA"logon account caps
HPAUTOCONTW B PLenables (TRUE); disables (FALSE) the automatic CONTINUE featureFALSE
HPCIDEPTHR I PLnumber of nested CIs1(=Root CI)
HPCIERRW Ilast CI error/warning in current sessionzero
HPCIERRCOLW Ierror column number for last CI error/warning zero
HPCIERRMSGR Stextual message for the most recent CIERROR (length of message is 0 for nonexistent CIERROR values)(null)
HPCMDNUMR I PLcurrent command sequence number1
HPCMDTRACEW B PLenables (TRUE); disables (FALSE) the User Command Tracing facilityFALSE
HPCMEVENTLOGW Iwhen set to n, $STDLIST displays the following n occurrences of tos/reg trapzero
HPCONNMINSR Icurrent session connect-time in minuteszero
HPCONNSECSR Icurrent session connect-time in secondszero
HPCONSOLER ILDEV of the consoleconsole LDEV at logon
HPCONTINUER B PLCI's continue state: FALSE=inactive, TRUE=activeFALSE
HPCPUNAMER Sname of computer model, for example, "SERIES 930"name of your logon computer model
HPCPUMSECSR Ifrom root CI = current session CPU-time in milliseconds; from other CI or process = current process CPU-time in millisecondszero
HPCPUSECSR Ifrom root CI = current session CPU-time in seconds; from other CI or process = current process CPU-time in secondszero
HPCWDR Scurrent working directorylogon group and account
HPDATER Icurrent day of monthlogon day of the month
HPDATEFR Scurrent formatted datelogon date
HPDAYR Icurrent day of the week (1=SUNDAY)logon day of the week
HPDTCPORTIDR Sport ID of data terminalnull string
HPDUPLICATIVER B PLindicates whether or not input operations are echoed to a correspondind device; TRUE (duplicative)= echoing occurs; FALSE (nonduplicative)= no echoing occursas appropriate
HPERRDUMPW I PLnumber of errors to be dumped from process error stackzero
HPERRTOSLISTW B PLcontrols destination of CI error messages: TRUE=errors written to $STDLIST, FALSE=errors written to $STDERRTRUE
HPEXECJOBSR Inumber of jobs and sessions currently in EXEC (executing) statenumber of jobs and sessions in EXEC state
HPFILER Scurrently executing UDC or command filenull string
HPGROUPR Scurrent group namelogon group name
HPGROUPCAPR Icurrent group capability masklogon group caps
HPGROUPCAPFR Scurrent group formatted capability mask, for example, "IA,BA,PH"logon group caps
HPHGROUPR Shome group namehome group
HPHOURR Icurrent hour number (24-hour clock)logon hour
HPINBREAKR B PLFALSE=not in BREAK; TRUE=in BREAK mode (includes process BREAK and rit BREAK)FALSE
HPINPRIR Iinput prioritylogon input priority
HPINTERACTIVER B PLinteractive (TRUE); noninteractive (FALSE) as appropriate
HPINTRODATER Sformatted job/session logon datedate of logon
HPINTROTIMER Sformatted job/session logon timetime of logon
HPJOBCOUNTR Inumber of jobs executinglogon number of executing jobs
HPJOBFENCER Ifence value for waiting jobslogon jobfence
HPJOBLIMITR Icurrent job limitjob limit at logon
HPJOBNAMER Sname of current job/sessionlogon job name
HPJOBNUMR Ijob/session number, for example, 12your job/session number
HPJOBTYPER S"S"=session, "J"=jobyour job type
HPLASTJOBW Sjob ID of the job you most recently streamed in the form #Jnnnnnull string
HPLASTSPIDR Sspoolfile ID for the job identified in the HPLASTJOB variablespoolfile ID of last job
HPLDEVINR ILDEV number for $STDINlogon input LDEV
HPLDEVLISTR ILDEV number for $STDLISTlogon output LDEV
HPLOCIPADDRR SIP address of a remote clientnull string
HPLOCPORTR ITCP port number for network service provided to the client0 if local client; otherwise standard port used by service
HPMINUTER Icurrent minute numberlogon minute
HPMONTHR Icurrent month numberlogon month
HPMSGFENCEW I PLfence for the level of error messages printed by the CI: See HELP HPMSGFENCE for values and expression evaluation diagnostics0
HPNCOPIESR Inumber of $STDLIST copies for jobscopies subparm of the outclass= parm of the JOB command
HPOSVERSIONR Soperating system version ID (identical to the middle version string in the SHOWME bannercurrent full version ID of the operating system
HPOUTCLASSR Soutput device classlogon output device class
HPOUTFENCER Ioutput fence valuelogon output fence value
HPPATHW Ssearch path for command files and implied RUN"!HPGROUP,PUB,PUB.SYS, ARPA.SYS"
HPPINR IProcess Identification Number for the executing processPIN for the root CI
HPPROMPTW SCI's prompt string":" (colon)
HPQUIETR Bindicates if session is accepting messages: FALSE= accepting messages; TRUE= not accepting messages ("quiet")FALSE
HPREDOSIZEW I PLnumber of entries in the CI's redo stack20
HPRELVERSIONR Soperating system release version ID (identical to the left version string in the SHOWME bannercurrent full version ID of the operating system
HPREMIPADDRR SIP address of the remote usernull string
HPREMPORTR ITCP port number, assigned by the client, used on an incoming connection0 if local client; otherwise the assigned TCP port number
HPRESULTW S I or Bvalue of the most recent CALC command evaluated (for example, "abc", 12, TRUE)zero
HPSCHEDJOBSR Inumber of jobs currently in SCHED state (scheduled state)number of jobs in SCHED state
HPSESCOUNTR Inumber of sessions executinglogon number of sessions executing
HPSESLIMITR Icurrent session limitsession limit at logon
HPSPOOLIDR Sspoolfile ID of the current jobjob spoolfile ID
HPSTDINR Sfile name for job or session input$STDIN
HPSTDLISTR Sfile name for job or session output listing $STDLIST
HPSTREAMEDBYR Suser and account name of the person who streamed a job or invoked STARTSESS; if "the person" is the initial OPERATOR.SYS logon or a job streamed from the SYSSTART.PUB.SYS file, the job or session ID is replaced by the string SYSTEM PROCESSlogon ID of the person who streamed the job
HPSUSANR Iunique serial number assigned at the factory to each system for use by softwareunique serial number assigned to your system at manufacture
HPSUSPJOBSR Icurrent number of jobs in SUSP state (suspended) numbers of jobs in SUSP state at logon
HPSYSNAMEW Sname of computer system (user-definable)null string (" ")
HPTIMEFR Scurrent formatted timelogon time
HPTIMEOUTW I PLnumber of minutes for CI reads (<=0 means no timeout). When this expires on a CI read, session is logged off.zero
HPTYPEAHEADW Bindicates whether or not typeahead is turned on; the BYE or SETVAR commands reset this variable to FALSE.FALSE.
HPUSERR Scurrent user namelogon user
HPUSERCAPR Icurrent user's capability masklogon user caps
HPUSERCAPFR Scurrent user's formatted capability mask, for example, "IA,BA,PH"logon user caps
HPUSERCMDEPTHR I PLnumber of nested UDCs and/or command fileszero
HPUSERCOUNTR Inumber of current online users0 if user-based pricing is not installed; otherwise the number of current users
HPUSERLIMITR Ilimit of number of online users-1 if user-based pricing is not installed; otherwise the user limit number
HPVERSIONR SMPE/iX version id (v.uu.ff)current MPE/iX version
HPWAITJOBSR Icurrent number of jobs waitingnumber of jobs waiting at logon time
HPYEARR Ilast two digits of the current yearlogon year number
JCWW JCWjob control word (variable)zero
R

[1] READ ONLY variable (cannot be modified).

W

READ/WRITE variable (can be modified).

JCW

A standard MPE/iX JCW.

I

Integer format.

B

Boolean format (TRUE/FALSE).

S

String (ASCII) format.

PL

Process Local. Modifications exist only for the locality of the process.

 

If a PL variable is changed by a process it returns to its original value when the process terminates. For example, if you logon and set HPREDOSIZE (the number of entries in the CI's redo stack) to 25 and then run a program which sets it to 30 (using the COMMAND or HPCICOMMAND intrinsics) the variable will have the value 30 for that process only. When the process terminates the value of this variable for your session remains at the value it was before the program was run (in this case 25).

PL (process local) variables are not programmatically accessible with the HPCIGETVAR, HPCIPUTVAR, and HPCIDELETEVAR intrinsics. They may be programmatically accessed only with the COMMAND or HPCICOMMAND intrinsics.

Note that HPTYPEAHEAD cannot be set inside a job. All user-created variables may be modified and deleted. However, Hewlett-Packard predefined variables may not be deleted.

JCWs may be considered integer variables with legal values ranging from 0 to 65,535 and with bits 16 and 17 (bit 0 being the leftmost bit of 32 bits) having special interpretations (for example, if bit 16 is set, the JCW setting is FATAL) and with bits 0 through 15 reserved.

Feedback to webmaster