Introduction to MVS 3 - Login and TSO
=====================================

OK, so we've had a bit of history, and a look at the console access
available to the high priests. What does the system look like to an
end-user?

Login Screen
------------

The first thing you see when you connect your TN3270 client to the
system. Almost all sites customise this to display company logos,
warnings, help info, etc. There's a (seemingly dormant) project
mapping all internet-accessible mainframe systems [1] you can check
out if you want to see some of the things other people come up with.

This is what I see (on a P390 system running OS/390):

SOURCE DATA SET = SYS1.VTAM.SOURCE(USSN)

                            W E L C O M E  T O


                  SSSSSS   //   3333333   9999999   0000000
                SS        //   33   33   99   99   00   00
               SS        //        33   99   99   00   00
                SSSS    //     33333   9999999   00   00
                   SS  //        33        99   00   00
                  SS  //   33   33   99   99   00   00
            SSSSSSS  //   3333333   9999999   0000000


TERMINAL NAME = SC0TCP01            NETWORK-QUALIFIED NAME =
SSCPNAME =                          NETWORK-ID =           192.168.168.23

          OS/390 APPLICATION SERVICES SYSTEM - RELEASE 2.10.0

===> ENTER "LOGON" FOLLOWED BY THE TSO USERID. EXAMPLE "LOGON IBMUSER" OR
===> ENTER L FOLLOWED BY THE APPLID
===> EXAMPLES: "L TSO", "L CICS", "L IMS3270

Logging In
----------

The cursor sits at the bottom of the screen waiting for me to input
something. I'll log in by entering

logon lee

and hitting enter. This sends me to the TSO logon screen:

------------------------------- TSO/E LOGON -----------------------------------


   Enter LOGON parameters below:                   RACF LOGON parameters:

   Userid    ===> LEE

   Password  ===>                                  New Password ===>

   Procedure ===> ISPFPROC                         Group Ident  ===>

   Acct Nmbr ===> 1337

   Size      ===> 40000

   Perform   ===>

   Command   ===> ispf

   Enter an 'S' before each option desired below:
           -Nomail         -Nonotice      S -Reconnect        -OIDcard

PF1/PF13 ==> Help    PF3/PF15 ==> Logoff    PA1 ==> Attention    PA2 ==> Reshow
You may request specific help information by entering a '?' in any entry field


Where I need to enter (at least) my password. A few things probably
need some explanation, right?

Userid                 : your username
Password/New Password  : current password, and new password if you wish to
                        change it
Procedure              : Kind of similar to .profile/.bashrc/.bash_profile/etc
                        you find in Unix, for setting up your environment
Group Ident            : RACF group id
Acct Nmbr              : system use can be charged to a particular account
                        number for billing purposes (eg. for cross-charge to
                        another department)
Size                   : the memory region size required in KiB
Perform                : performance group assignment (rarely used since the
                        introduction of Workload Manager)
Command                : an initial command to run once logged-in


For this demo, I'll blank out the 'Command' field so I get straight to
a TSO prompt, fill in the Password field, and hit enter:


ICH70001I LEE      LAST ACCESS AT 11:11:48 ON WEDNESDAY, OCTOBER 30, 2019
IKJ56455I LEE LOGON IN PROGRESS AT 12:42:12 ON OCTOBER 31, 2019
IKJ56951I NO BROADCAST MESSAGES
******************************************************************
*                                                                *
*                  WELCOME TO THE P390 SYSTEM!                   *
*                                                                *
*  THIS MESSAGE IS KEPT IN DATA SET SYS1.CLIST(ISPFCL), AND      *
*  CAN BE CHANGED TO READ AS YOU WISH.                           *
*                                                                *
*  USERIDS SUPPLIED ARE IBMUSER, P390, P390A THROUGH P390Z,      *
*  TESTER, AND OPEN1 THROUGH OPEN3.  IBMUSER AND P390 HAVE       *
*  AUTHORITY TO GRANT THEMSELVES ANY ADDITIONAL AUTHORIZATIONS   *
*  THEY WANT.  P390A THROUGH P390Z AND TESTER ARE RESTRICTED     *
*  FROM ALTERING SYSTEM DATA SETS, SUCH AS THOSE STARTING WITH   *
*  "SYS1."  OPEN1 THROUGH OPEN3 HAVE UID(0) AUTHORITY AND ARE    *
*  CONNECTED TO GROUP SYS1.  THEY CAN ALL BE LOGGED ON AT THE    *
*  SAME TIME.  OPEN1 THROUGH OPEN3 WILL BE AUTOMATICALLY PLACED  *
*  INTO AN OPENEDITION SHELL SESSION WHEN THEY LOG ON.           *
*                                                                *
*  THE PASSWORD CHANGE INTERVAL IS SET TO 180 DAYS, AND THERE    *
*  ARE NO PASSWORD RULES IN EFFECT.  THE INTERVAL CAN BE CHANGED *
*  WITH THE RACF "SETROPTS" COMMAND.  NEW USERIDS CAN BE ADDED   *
***


The three asterisks at the bottom is TSO informing you that there's
more information to follow, and I should hit enter to page down:


*  USING THE TSO ACCOUNT AND RACF AU COMMANDS, OR YOU CAN CHANGE *
*  TO RACF-ONLY ADMINISTRATION.                                  *
*                                                                *
*  THERE ARE TWO LOGON PROCS AUTHORIZED FOR ALL IDS.  IKJACCNT   *
*  IS TSO-ONLY (USEFUL FOR RECOVERY WHEN TESTING ISPF APPLICAT-  *
*  ONS), AND ISPFPROC PROVIDES ISPF FUNCTION.                    *
*                                                                *
******************************************************************

READY


'READY' is the TSO prompt.

Help
----

Besides the Users Guide [2], TSO also has some limited online
documentation, which is accessed via 'HELP' (my input is in
lower-case):

READY
help
LANGUAGE PROCESSING COMMANDS:

ASM        INVOKE ASSEMBLER PROMPTER AND ASSEMBLER F COMPILER.
CALC       INVOKE ITF:PL/1 PROCESSOR FOR DESK CALCULATOR MODE.
COBOL      INVOKE COBOL PROMPTER AND ANS COBOL COMPILER.
FORT       INVOKE FORTRAN PROMPTER AND FORTRAN IV G1 COMPILER.

PROGRAM CONTROL COMMANDS:

CALL       LOAD AND EXECUTE THE SPECIFIED LOAD MODULE.
LINK       INVOKE LINK PROMPTER AND LINKAGE EDITOR.
LOADGO     LOAD AND EXECUTE PROGRAM.
RUN        COMPILE, LOAD, AND EXECUTE PROGRAM.
TEST       TEST USER PROGRAM.
TESTAUTH   TEST APF AUTHORIZED PROGRAMS.

DATA MANAGEMENT COMMANDS:

ALLOCATE   ALLOCATE A DATA SET WITH OR WITHOUT AN ATTRIBUTE
           LIST OF DCB PARAMETERS.
ALTLIB     DEFINE OPTIONAL, USER-LEVEL OR APPLICATION-LEVEL SETS OF
***

(I'll only include the first page of output here)

Appending a command name to 'HELP' will give specific help for that
command:

READY
help allocate

FUNCTION -
  THE ALLOCATE COMMAND PERFORMS THE FOLLOWING FUNCTIONS:
        - DYNAMICALLY DEFINES AND ALLOCATES A DATA SET WITH OR
          WITHOUT AN ATTRIBUTE LIST OF DCB PARAMETERS.
        - ALLOCATES A NEW DATASET WITH ATTRIBUTES COPIED FROM AN
          EXISTING DATA SET.
        - CONCATENATES A LIST OF DATA SETS.
        - ALLOCATES AN HFS FILE.
  FOR SPECIAL CONSIDERATIONS WHEN USING SMS SEE THE "TSO/E COMMAND
     REFERENCE" MANUAL.

SYNTAX  -
         ALLOCATE   DATASET('DSNAME'/'LIST OF DSNAMES'/*)
                       OR
                    DUMMY
                    FILE('DDNAME') ALTFILE('DDNAME')
                    DEST('DESTINATION' OR 'NODE.USERID')
                    NEW/OLD/MOD/SHR/SYSOUT('CLASS')
                    VOLUME('SERIAL'/SERIAL LIST)/MSVGP('IDENTIFIER')
                    SPACE('QUANTITY','INCREMENT') DIR('INTEGER')
***

Easy. To start doing anything useful though, we need to know about how
data is stored and retrieved in an MVS system. On to part 4!


[1] https://mainframesproject.tumblr.com/
[2] https://www-01.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3sa320971/$file/ikjc200_v2r3.pdf

You are viewing proxied material from republic.circumlunar.space. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.