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

3.26 AIFJSGET/PUT Items

MPE documents

Complete PDF

 

Table of Contents

Index

 

⇓ Page Bottom

Item Descriptions
Summary
Item Descriptions

⇑ Page Top

 

3.25 AIFJSPUT

3.27 AIFKSMCREATE

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

Item Type Description Put Ver Min Max Error#
1001 CA16Job nameYY
1002 I32Job stateNY
1003 BDuplicative?YY
1004 BInteractive?YY
1005 BQuiet mode?YY
1006 B$STDLIST stateYY
1007 I32Input priorityYY015-1005
1008 I32Output priorityYY014-1008
1009 CA16User nameNY
1010 CA16Group nameNY
1011 CA16Account nameNY
1012 I32Input deviceNY
1013 JSDev_typeOutput deviceYY
1014 I32Start dateYY
1015 I32Start timeYY
1016 I32Execution priorityYY100250-1009
1017 I32JSMAIN PINNY
1018 I32CI PINNY
1019 I32CPU limitYY-132767-1010
1020 BSpooled?NY
1021 BRestart?YY
1022 BNumbered job?NY
1023 BProgrammatic session?NY
1024 I32Max account job priorityNY
1025 I32Account securityYY
1026 I32Group securityYY
1027 CA16Home group nameNY
1028 I32CPU countNY
1029 I32Directory CPU countNY
1030 I32Account local attributesYY
1031 I32User capabilitiesYY
1032 I32General resource capabilitiesYY
1033 I32# creationsNY
1034 BA96Allow maskYY
1035 Longint_typeLogon timestampNY
1036 I32CI time outYY
1037 JSNum_typeJob/session numberNY
1038 I32Job wait indexNN
1039 BSession?NY
1040 BNetwork services?NY
1043 CA16HP DTC PortidNY
1044 RECJob submitter job/session numberNY
1045 CA16Job submitter job/session nameNY
1046 CA16Job submitter user nameNY
1047 CA16Job submitter account nameNY
1048 I32Job submitter logical deviceNY
1049 I32Job submitter session/job introduction dateNY
1050 I32Job 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 Number Item 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   DISALLOW    = 20  MRJECONTROL = 38
 ACCEPT      = 2   JOBFENCE    = 21  JOBSECURITY = 39
 DOWN        = 3   LIMIT       = 22  DOWNLOAD    = 40
 GIVE        = 4   STOPSPOOL   = 23  MIOENABLE   = 41
 HEADOFF     = 5   SUSPENDSPOOL= 24  MIODISABLE  = 42
 HEADON      = 6   OUTFENCE    = 25  LOG         = 43
 REFUSE      = 7   RECALL      = 26  FOREIGN     = 44
 REPLY       = 8   RESUMEJOB   = 27  IMF CONTROL = 45
 STARTSPOOL  = 9   RESUMESPOOL = 28  SHOWCOM     = 46
 TAKE        = 10  STREAMS     = 29  OPENQ       = 47
 UP          = 11  CONSOLE     = 30  SHUTQ       = 48
 MPLINE      = 12  WARN        = 31  DISCRPS     = 49
 DSCONTROL   = 13  WELCOME     = 32  VSRESERVESYS= 50
 ABORTJOB    = 14  MON         = 33  VSRELEASESYS= 51
 ALLOW       = 15  MOFF        = 34  VSCLOSE     = 52
 ALTSPOOLFILE= 16  VMOUNT      = 35  VSOPEN      = 53
 ALTJOB      = 17  LMOUNT      = 36  SPOOLER     = 54
 BREAKJOB    = 18  LDISMOUNT   = 37  
 DELETESPOOLFILE = 19                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.



3.25 AIFJSPUT

3.27 AIFKSMCREATE