HPlogo 900 Series HP 3000 Computer Systems: MPE/iX Architected Interface Facility: Operating System Reference Manual > Chapter 3 Architected Interface Descriptions

AIFJSGET/PUT Items

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

The following two tables provide summary and detailed descriptions of the item numbers associated with job/session information.

Item Summary

The following table summarizes the item numbers associated with job/session information. For more detailed information about these item numbers, refer to the table of job/session information item descriptions.

Table 3-15 Job or Session Information Item Summary

ItemTypeDescriptionPutVerMinMaxError#
1001CA16Job nameYY   
1002I32Job stateNY   
1003BDuplicative?YY   
1004BInteractive?YY   
1005BQuiet mode?YY   
1006B$STDLIST stateYY   
1007I32Input priorityYY015-1005
1008I32Output priorityYY014-1008
1009CA16User nameNY   
1010CA16Group nameNY   
1011CA16Account nameNY   
1012I32Input deviceNY   
1013JSDev_typeOutput deviceYY   
1014I32Start dateYY   
1015I32Start timeYY   
1016I32Execution priorityYY100250-1009
1017I32JSMAIN PINNY   
1018I32CI PINNY   
1019I32CPU limitYY-132767-1010
1020BSpooled?NY   
1021BRestart?YY   
1022BNumbered job?NY   
1023BProgrammatic session?NY   
1024I32Max account job priorityNY   
1025I32Account securityYY   
1026I32Group securityYY   
1027CA16Home group nameNY   
1028I32CPU countNY   
1029I32Directory CPU countNY   
1030I32Account local attributesYY  
1031I32User capabilitiesYY   
1032I32General resource capabilitiesYY   
1033I32# creationsNY   
1034BA96Allow maskYY   
1035Longint_typeLogon timestampNY   
1036I32CI time outYY   
1037JSNum_typeJob/session numberNY   
1038I32Job wait indexNN   
1039BSession?NY   
1040BNetwork services?NY   
1043CA16HP DTC PortidNY   
1044RECJob submitter job/session numberNY   
1045CA16Job submitter job/session nameNY   
1046CA16Job submitter user nameNY   
1047CA16Job submitter account nameNY   
1048I32Job submitter logical deviceNY   
1049I32Job submitter session/job introduction dateNY   
1050I32Job submitter session/job introduction timeNY   

 

Item Descriptions

The following table provides detailed descriptions of item numbers and corresponding items associated with job/session information.

Table 3-16 Job or Session Information Item Descriptions

Item NumberItem Name (Data Type) Put; Verify; Release First Available Description
1001

Job name (CA16) Put: Yes; Verify: Yes; Release 3.0

Returns or modifies the identifier given to a job or session. It must be left-justified, all capitals, and padded with blanks. All blanks represent a job or session that does not have a job name. Only the first eight characters may be changed using AIFJSPUT.

1002

Job state (I32) Put: No; Verify: Yes; Release 3.0

Returns the current state of the job or session. If a job or session is in the EXEC* state, there is no guarantee that any of the values returned by the AIF are valid. Values and their meanings are:

1

Introduced (INTRO)

2

Executing (EXEC)

3

Terminating (TERM)

4

Suspended (SUSP)

32

Waiting (WAIT)

40

Error (ERROR)

48

Initializing (EXEC*)

56

Scheduled (SCHED)

1003

Duplicative? (B) Put: Yes; Verify: Yes; Release 3.0

Returns or modifies the duplicative status of the job or session. True when all input operations for a job or session are echoed to a corresponding device without intervention by the operating system software.

1004

Interactive? (B) Put: Yes; Verify: Yes; Release 3.0

Returns or modifies the interactive status of the job or session. True when human intervention is required for all input operations for a job or session.

1005

Quiet mode? (B) Put: Yes; Verify: Yes; Release 3.0

Returns or modifies the mode status of the job or session. True when the job or session is in quiet mode. While in quiet mode, the job or session will not receive TELL messages.

1006

$STDLIST state (B) Put: Yes; Verify: Yes; Release 3.0

Returns or modifies the $STDLIST final disposition. True when a SET STDLIST=DELETE is invoked for a job ($STDLIST is deleted after job termination). False when $STDLIST is to be saved after job termination.

1007

Input priority (I32) Put: Yes; Verify: Yes; Release 3.0

Returns or modifies the current input priority (INPRI) of the job. When a job's INPRI is higher than the system JOBFENCE, the system allows the job to execute. The input priority should be a value in the range 0..15. The value 15 is equivalent to using the ;HIPRI option of the JOB command.

1008

Output priority (I32) Put: Yes; Verify: Yes; Release 3.0

Returns or modifies the current output priority (OUTPRI) of the job. When a job's OUTPRI is higher than the outfence of the output device, the spool file that is associated with the $STDLIST for that job is sent to the device. The output should be a value in the range 0..14.

1009

User name (CA16) Put: No; Verify: Yes; Release 3.0

Returns the name of the user that the job or session is logged on to. It is left-justified and padded with blanks.

1010

Group name (CA16) Put: No; Verify: Yes; Release 3.0

Returns the name of the group that the job or session is logged on to. This is left-justified and padded with blanks.

1011

Account name (CA16) Put: No; Verify: Yes; Release 3.0

Returns the name of the account that the job or session is logged on to. This is left-justified and padded with blanks.

1012

Input device (I32) Put: No; Verify: Yes; Release 3.0

Returns the LDEV number associated with $STDIN for this job or session.

1013

Output device (REC) Put: Yes; Verify: Yes; Release 3.0

Returns or modifies a record that has two fields, a boolean and an integer. If the boolean is true, the integer contains a DCT index; otherwise, it contains the LDEV number of the output device for the job or session.

Do not change the output device for sessions.

1014

Start date (I32) Put: Yes; Verify: Yes; Release 3.0

Returns or modifies the date that the job or session first logged on. If it is for a scheduled job, it is the date that the job is scheduled to start. Start date is of the following format:

Bits (0:16)

Start date (unused)

Bits (16:7)

Start date (Year after 1900)

Bits (23:9)

Start date (Day of Year)

Do not change the start date of a job in the SCHED state because a change to one job may impact all jobs in the SCHED state.

1015

Start time (I32) Put: Yes; Verify: Yes; Release 3.0

Returns or modifies the time that the job or session first logged on. If it is for a scheduled job, it is the time that the job is scheduled to start. It is of the format:

Bits (0:8)

Start time (Hour of Day)

Bits (8:8)

Start time (Minute of Hour)

Bits (16:8)

Start time (Second of Minute)

Bits (24:8)

Start time (Tenth of Second)

Do not change the start time of a job in the SCHED state because a change to one job may impact all jobs in the SCHED state.

1016

Executing priority (I32) Put: Yes; Verify: Yes; Release 3.0

Returns or modifies a priority that translates to the base of the queue that the job or session is logged on to. Values and their associated queues areas follows:

100

BS queue

150

CS queue

200

DS queue

250

ES queue

1017

JSMain PIN (I32) Put: No; Verify: Yes; Release 3.0

Returns the process identification number (PIN) of the JSMain process for the job or session. A zero is returned if the job or session is in a wait state.

1018

CI PIN (I32) Put: No; Verify: Yes; Release 3.0

Returns the process identification number (PIN) of the command interpreter for the job or session. Not valid for jobs in the WAIT state.

1019

CPU limit (I32) Put: Yes; Verify: Yes; Release 3.0

Returns or modifies the CPU time limit for the job or session. A value of -1 is equivalent to no CPU limit, the default for any job or session. Both the HELLO and JOB commands have a TIME parameter for changing this to a number from 1 to 32,767. This value is in seconds.

1020

Spooled? (B) Put: No; Verify: Yes; Release 3.0

Returns or modifies the spooled state of a $STDIN. True when $STDIN for a job is a spooled device. Because there are no hot jobs on MPE/iX, this item should always remain true.

1021

Restart? (B) Put: Yes; Verify: Yes; Release 3.0

Returns or modifies the RESTART status of a job. True when the RESTART option was specified for a job. If the system goes down before a job with RESTART completes, that job is automatically rescheduled when the system comes back up.

1022

Numbered job? (B) Put: No; Verify: Yes; Release 3.0

Returns or modifies whether the text file containing the job is numbered. True when the actual text file containing the job is numbered.

1023

Programmatic session? (B) Put: No; Verify: Yes; Release 3.0

Returns or modifies the programmatic session status of a session. True when a session is a programmatic session (created using the STARTSESS command or the STARTSESS intrinsic).

1024

Maximum account job priority (I32) Put: No; Verify: Yes; Release 3.0

Returns or modifies a priority that is the maximum allowed for the account that the job or session is logged on to. The maximum priority for an account is specified by using the MAXPRI parameter of the NEWACCT and ALTACCT command. Not valid for jobs in the WAIT state. The values and their associated queues are as follows:

100

BS queue

150

CS queue

200

DS queue

250

ES queue

1025

Account security (I32) Put: Yes; Verify: Yes; Release 3.0

Returns or modifies the security mask for the account that the job or session is logged on to. The account security mask can also be set using the ALTSEC command. Not valid for jobs in the WAIT state. The bits of the mask have the following meanings:

Bits (0:20)

Unused

Bit (20:1)

Read any

Bit (21:1)

Read account user

Bit (22:1)

Append any

Bit (23:1)

Append account user

Bit (24:1)

Write any

Bit (25:1)

Write account user

Bit (26:1)

Lock any

Bit (27:1)

Lock account user

Bit (28:1)

Execute any

Bit (29:1)

Execute account user

Bits (30:2)

Unused

1026

Group security (I32) Put: Yes; Verify: Yes; Release 3.0

Returns or modifies the security mask for the group that the job or session is logged on to. The group security mask can also be set using the ALTSEC command. Not valid for jobs in the WAIT state. The bits of the mask have the following meanings:

Bits (0:2)

Unused

Bit (2:1)

Read any

Bit (3:1)

Read account user

Bit (4:1)

Read account librarian

Bit (5:1)

Read group user

Bit (6:1)

Read group librarian

Bit (7:1)

Append any

Bit (8:1)

Append account user

Bit (9:1)

Append account librarian

Bit (10:1)

Append group user

Bit (11:1)

Append group librarian

Bit (12:1)

Write any

Bit (13:1)

Write account user

Bit (14:1)

Write account librarian

Bit (15:1)

Write group user

Bit (16:1)

Write group librarian

Bit (17:1)

Lock any

Bit (18:1)

Lock account user

Bit (19:1)

Lock account librarian

Bit (20:1)

Lock group user

Bit (21:1)

Lock group librarian

Bit (22:1)

Execute any

Bit (23:1)

Execute account user

Bit (24:1)

Execute account librarian

Bit (25:1)

Execute group user

Bit (26:1)

Execute group librarian

Bit (27:1)

Save any

Bit (28:1)

Save account user

Bit (29:1)

Save account librarian

Bit (30:1)

Save group user

Bit (31:1)

Save group librarian

1027

Home group (CA16) Put: No; Verify: Yes; Release 3.0

Returns the name of the home group for the user that the job or session is logged on to. This is left-justified and padded with blanks. Not valid for jobs in the WAIT state.

1028

CPU count (I32) Put: No; Verify: Yes; Release 3.0

Returns the number of milliseconds of CPU time used by processes within the job or session that have already died. Not valid for jobs in the WAIT state.

1029

Directory CPU count (I32) Put: No; Verify: Yes; Release 3.0

Returns the number of seconds of CPU time that the job or session has already been charged for as of the last CHGROUP command. Not valid for jobs in the WAIT state.

1030

Account local attributes (I32) Put: Yes; Verify: Yes; Release 3.0

Returns or modifies the account local attributes for the account that the job or session is currently logged on to. These attributes are an extension of MPE/iX security and are not required. Their meaning is user defined, although the first 16 bits are unused. Not valid for jobs in the WAIT state.

1031

User capabilities (I32) Put: Yes; Verify: Yes; Release 3.0

Returns or modifies the user capability mask for the job or session. Not valid for jobs in the WAIT state. Mask bits and their meanings are as follows:

Bits (0:16)

Unused

Bit (16:1)

System manager

Bit (17:1)

Account manager

Bit (18:1)

Account librarian

Bit (19:1)

Group librarian

Bit (20:1)

Diagnostician

Bit (21:1)

System supervisor

Bit (22:1)

Create volume sets

Bit (23:1)

Use private volumes

Bit (24:1)

Use user logging

Bit (25:1)

Unused

Bit (26:1)

Programmatic sess

Bit (27:1)

Network administrator

Bit (28:1)

Node manager

Bit (29:1)

Use comm subsystem

Bit (30:1)

Non-shareable device

Bit (31:1)

Save files

1032

General resource capabilities (I32) Put: Yes; Verify: Yes; Release 3.0

Returns or modifies the general resources capability mask for the job or session. This mask contains the general resource capabilities for the user that the job or session is logged on to. Not valid for jobs in the WAIT state. Mask bits and their meanings are as follows:

Bits (0:23)

Unused

Bit (23:1)

Batch access

Bit (24:1)

Interactive access

Bit (25:1)

Privileged mode

Bit (26:2)

Unused

Bit (28:1)

Multiple RINs

Bit (29:1)

Unused

Bit (30:1)

Extra data segment

Bit (31:1)

Process handling

1033

Number of creations (I32) Put: No; Verify: Yes; Release 3.0

Returns the number of process creations performed by the job or session. This number does not include the command interpreter, and it is a count that is kept for the life of the job or session. Not valid for jobs in the WAIT state.

1034

Allow mask (BA96) Put: Yes; Verify: Yes; Release 3.0

Returns or modifies the commands allowed for this session in a packed array of 96 booleans. True is returned if the command is allowed for the job or session. Not valid for jobs in the WAIT state. The commands and their array locations are as follows:

   ABORTIO     = 1      DELETESPOOLFILE = 19    LDISMOUNT    = 37

   ACCEPT      = 2      DISALLOW     = 20       MRJECONTROL  = 38

   DOWN        = 3      JOBFENCE     = 21       JOBSECURITY  = 39

   GIVE        = 4      LIMIT        = 22       DOWNLOAD     = 40

   HEADOFF     = 5      STOPSPOOL    = 23       MIOENABLE    = 41

   HEADON      = 6      SUSPENDSPOOL = 24       MIODISABLE   = 42

   REFUSE      = 7      OUTFENCE     = 25       LOG          = 43

   REPLY       = 8      RECALL       = 26       FOREIGN      = 44

   STARTSPOOL  = 9      RESUMEJOB    = 27       IMF CONTROL  = 45

   TAKE        = 10     RESUMESPOOL  = 28       SHOWCOM      = 46

   UP          = 11     STREAMS      = 29       OPENQ        = 47

   MPLINE      = 12     CONSOLE      = 30       SHUTQ        = 48

   DSCONTROL   = 13     WARN         = 31       DISCRPS      = 49

   ABORTJOB    = 14     WELCOME      = 32       VSRESERVESYS = 50

   ALLOW       = 15     MON          = 33       VSRELEASESYS = 51

   ALTSPOOLFILE = 16    MOFF         = 34       VSCLOSE      = 52

   ALTJOB      = 17     VMOUNT       = 35       VSOPEN       = 53

   BREAKJOB    = 18     LMOUNT       = 36       SPOOLER      = 54

                                                unused       = 55..96
1035

Logon time stamp (I64) Put: No; Verify: Yes; Release 3.0

Returns the time stamp for the time that the job or session logged on. The value is in microseconds. Not valid for jobs in the WAIT state.

1036

CI time out (I32) Put: Yes; Verify: Yes; Release 3.0

Returns or modifies the number of minutes that the command interpreter waits for a response before logging the session off. If this value is 0, the CI does not log off the session. This value is the same as the CI variable HPTIMEOUT. Not valid for jobs in the WAIT state.

1037

Job/Session number (I32) Put: No; Verify: Yes; Release 3.0

Returns the job/session number for the specified job or session, in the following form:

Bits (0:2)

Job or Session? (1 = Session, 2 = Job)

Bits (2:14)

Number

Bits (16:16)

Extension

1038

Job wait index (I32) Put: No; Verify: No; Release 3.0

Returns the index of the job in the wait queue, where the job with an index of 1 is the next to execute. Valid only for jobs in the WAIT state.

1039

Session? (B) Put: No; Verify: Yes; Release 3.0

Returns true if a session and false if a job.

1040

Network services? (B) Put: No; Verify: Yes; Release 3.0

Returns true when a job or session has a dsline open.

1041

Private? (B) Put: Yes; Verify: Yes; Release 4.0

Returns or modifies the PRIVATE option for the file $STDLIST. This option will only take affect for jobs in the introduced, scheduled, and waitstate before $STDLIST is opened. This item should not be used with item 1042 since PRIVATE spoolfiles may not be SPSAVEd.

1042

SPSAVE? (B) Put: Yes; Verify: Yes; Release 4.0

Returns or modifies the SPSAVE option for the job output $STDLIST file. When true, the spoolfile is not purged after the last copy has been printed. This option will only take affect for jobs in the introduced, scheduled, and waitstate before $STDLIST is opened. This item should not be used with item 1041.

1043

HP DTC Portid (CA16) Put: No; Verify: Yes; Release 4.0

Returns the hpdtcportid system variable in the SHOWVAR format.

The format of hpdtcportid is DTC LAN station address followed by SIC and port numbers (for example, 080009001111 0002).

1044

Job submitter job/session number (REC) Put: No; Verify: Yes; Release 4.0

Returns submitter information for both jobs and sessions. The job/session number is returned for the user who streamed the job or created the session. For system processes the job/session number returned is 0.

Record type: jsnum_type (Refer to appendix B).

1045

Job submitter job/session name (CA16) Put: No; Verify: Yes; Release 4.0

Returns the identifier name given to the submitter job or session. This is left-justified and padded with blanks. When the submitter is a system process, the name returned is blank.

1046

Job submitter user name (CA16) Put: No; Verify: Yes; Release 4.0

Returns the name of the user that streamed the job or started the session. This is left-justified and padded with blanks. When the submitter is a system process, the user name is MANAGER from MANAGER.SYS.

1047

Job submitter account name (CA16) Put: No; Verify: Yes; Release 4.0

Returns the name of the account the submitter was logged on to when they streamed the job or started the session. When the submitter is a system process, the account name is SYS for MANAGER.SYS.

1048

Job submitter logical device (I32) Put: No; Verify: Yes; Release 4.0

Returns the ldev number of the submitter. When the submitter is a system process, ldev 20 is returned.

1049

Job submitter session/job introduction date (I32) Put: No;Verify: Yes; Release 4.0

Returns the date the STREAM of STARTSESS request was issued.

Bits (0:16)

Submitter Date (Unused)

Bits (16:7)

Submitter Date (Year after 1900)

Bits (23:9)

Submitter Date (Day of Year)

1050

Job submitter session/job introduction time (I32) Put: No; Verify: Yes; Release 4.0

Returns the time the submitter issued the STREAM or STARTSESS command.

 

Feedback to webmaster