The ULOG utility program is used to perform the following functions:
Identify the terminal user to the Com-plete system;
Terminate the terminal user's session;
Alter the user's logon password.
ULOG must be used to identify the user to the Com-plete accounting and security routines. Otherwise, use of any application program or Com-plete utility will be disallowed.
A terminal session established through ULOG must also be terminated with ULOG.
Once a user is identified to Com-plete with ULOG, a so-called User Id accounting block (UAB) is created. Statistical information about every user in conversation with Com-plete is accumulated and maintained using this control block. This block is discarded from the system once a user logs off from Com-plete (using *ULOG OFF) or when Com-plete terminates.
This document covers the following topics:
When you invoke Com-plete, ULOG presents you with a logon screen:
19:02:07 TID 6 COM-5.1. User 05/22/97
ULG0
------------------------- Com-plete System Logon -------------------------
User ID ...........:
Password ..........:
New password ......:
Group (ACF2) ......:
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Cont End |
Enter your User ID and your current password and press .
Note:
A user ID and password are character strings uniquely identifying you
as user and are assigned to you by the system administrator. You can change
your password by supplying the "New Password" in addition to your current
password and pressing . Com-plete asks you to
confirm the new password by typing it a second time.
If you press or from the logon screen, the terminal is disconnected and you are returned to VTAM, the calling system (in case of ACCESS), or the logon screen is redisplayed, depending on your installation.
If the logon is successful, the broadcast message is displayed, together with a message with information concerning your last logon.
Note:
The broadcast message is defined using the SI function on the
Utilities menu, see the chapter on UUTIL.
The following figure shows a typical broadcast message:
COMULG0003 (8) Last access at 19:29:33 0n 05/22/97 Tid(SHRDAEN) Sys(COM-5.1.) *-----------------------> BROADCAST <--> COM-5.1. <----------------------* * * * W e l c o m e t o t h e * * * * w o n d e r f u l w o r l d o f * * * * CCCCC OOOOO MM MM PPPPP LL EEEEEEE TTTTTTTT EEEEEEE * * CCCCCCC OOOOOOO MM MMM MM PPPPPP LL EEEEEEE TTTTTTTT EEEEEEE * * CC OO OO MM M MM PP PP LL EE TT EE * * CC OO OO MM MM ****** PPPPPP LL EEEEE TT EEEEE * * CC OO OO MM MM ****** PPPPP LL EEEEE TT EEEEE * * CC OO OO MM MM PP LL EE TT EE * * CCCCCCC OOOOOOO MM MM PP LLLLLLL EEEEEEE TT EEEEEEE * * CCCCC OOOOO MM MM PP LLLLLLL EEEEEEE TT EEEEEEE * * * * * * * * >>> Version 5.1.1 <<< * *-----------------------------------------------------------------------------* |
Com-plete interfaces with the most commonly used external security system packages available for z/OS. When an error occurs during logon processing, these security systems pass one or more messages to Com-plete, describing the cause of the problem.
If only one message is received, it is displayed on the logon screen, for example:
19:33:12 TID 6 COM-5.1. User 05/22/97
ULG0
------------------------- COM-PLETE System Logon -------------------------
User ID ...........: SAGATEST
Password ..........:
New password ......:
Group (ACF2) ......:
ACF01004 LOGONID SAGATEST NOT FOUND
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Cont End |
If the External Security System answers the Com-plete logon request request with more than one message, you are notified with the following message displayed on the logon screen:
SAF Messages waiting ...
Press to display the security system messages. Up to 15 messages can be displayed.
There are some commands that can be issued to ULOG to access to the Com-plete system and to release or transfer control.
- ULOG ON
The ULOG ON command identifies you as a Com-plete terminal user to the Com-plete accounting and security routines. If applymod 52 is on, this command is automatically issued to Com-plete when you invoke Com-plete from VTAM.
The command format is:
*ULOG ON,userid,[password]where userid is a valid user ID. The password option must be specified if your installation requires it.
If you issue the *ULOG ON command from a Com-plete session on a terminal on which another user is already logged on, the first user is automatically logged off and you are logged on.
- ULOG OFF
This command logs you off from Com-plete; your terminal is disconnected from the Com-plete system.
The command format is:
*ULOG [OFF]The OFF operand is the default and therefore not required.
- ULOG STAY
This command is the equivalent of the ULOG OFF command, except that under VTAM, you are not returned to VTAM but to the Com-plete logon screen.
The command format is:
*ULOG STAY- ULOG DISC
Under VTAM, the ULOG DISC command forces disconnection from the terminal and you are returned to VTAM.
The command format is:
*ULOG DISC- ULOG PASS
This command forces a logoff and causes VTAM to establish a new session with the application specified in the command operands.
The command format is:
*ULOG PASS,VTAM-appl-ID<,userid><,user-data>where:
PASS Can be abbreviated to P. VTAM-appl-ID Required: specifies the ID of the VTAM application. The value specified can be up to eight bytes. userid Optional: specifies a user ID of up to eight bytes. user-data Optional: specifies data passed to the target application. Note:
Errors detected during command interpretation result in a normal logoff with an additional call to ULOGX1, passing the appropriate error code.