On 22 January 2015 at 16:51, Phil Smith <[email protected]> wrote:
> Does anyone understand or have any comments on the following analysis? This 
> all revolves around the TIOCSTPN and TIOCJSTN fields in the TIOT. There seem 
> to be three cases, depending on how the job was invoked. For each, assume the 
> job is named JOBNAME and the step is STEPNAME. "blanks" means, like, all 
> blanks.
>
> Run as a job:
> TIOCSTPN = STEPNAME, TIOCJSTN = blanks
> Run as a PROC without STCJOBS:
> TIOCSTPN = JOBNAME, TIOCJSTN = blanks
> Run as a PROC with STCJOBS:
> TIOCSTPN = STEPNAME, TIOCJSTN = JOBNAME
>
> So this is all well and good, but the three fields are documented in IEFTIOT1 
> as:
[First comes TIOCNJOB DS    CL8  -         JOB NAME]
> TIOCSTPN = 8-byte step name for non-PROCs
> TIOCPSTN = 8-byte PROC step name for procs
> TIOCJSTN = 8-byte jobstep name for PROCs

But TIOCSTPN and TIOCPSTN are the same area, so there are

> 1)      Is the documentation just wrong, or am I missing something?

Perhaps to muddy the waters... There are lots of control blocks that
contain or point to job/step/procstep names. I'd guess the TIOT fields
are (or were before started jobs came along in 1995 or so) filled from
the CSCB (with the quaint macro name IEECHAIN):

CHKEY    DS    CL8 -     1. ID OF A STARTED TASK
*                        (THIS ID IS THE TASK'S STEPNAME)
*                        2. JOBNAME OF AN EXECUTED JOB.
*                        3. Name of the ATX.                       @L9A
CHCLS    DS    CL8 -     1.PROCNAME OF A STARTED TASK
*                        (THE PROCNAME IS THE TASK'S JOBNAME.)
*                        2. JOBNAME OF AN EXECUTED JOB (SAME AS CHKEY)
CHUNIT   DS    CL3 -     UNITNAME (Set for started tasks only)     @PDC
*                        This field is not valid for 4-digit       @PDC
*                        device numbers. Use CHUNIT4 instead.      @PDC
...
CHUNIT4  DS    CL4 -     UNITNAME (SET FOR STARTED TASKS ONLY)

The ASCB (IHAASCB):

ASCBJBNI DS    A -                 POINTER TO JOBNAME FIELD FOR
*                                  INITIATED PROGRAMS OR ZERO
ASCBJBNS DS    A -                 POINTER TO JOBNAME FIELD FOR
*                                  START/MOUNT/LOGON OR ZERO

I suppose it depends on what you are trying to do.

> 2)      Are there other possible cases?

TSO sessions. Start command with a unit name. UNIX initiator. APPC
initiator. Probably others....  I don't know how these vary, but there
are still only three kinds of field to be filled, I think.

Tony H.

----------------------------------------------------------------------
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to [email protected] with the message: INFO IBM-MAIN

Reply via email to