ELowell at 23:05, 12 July 2016

2016-07-12T23:05:52Z

← Older revision		Revision as of 23:05, 12 July 2016
Line 1:		Line 1:
	The conventions used on this page are described in [[HLI: Function ~~call list~~#Function call notation conventions\|Function call notation conventions]].		The conventions used on this page are described in [[HLI: Function summary#Function call notation conventions\|Function call notation conventions]].

	==Summary==		==Summary==

ELowell at 22:12, 11 July 2016

2016-07-11T22:12:55Z

← Older revision		Revision as of 22:12, 11 July 2016
Line 1:		Line 1:
			The conventions used on this page are described in [[HLI: Function call list#Function call notation conventions\|Function call notation conventions]].

	==Summary==		==Summary==

ELowell: Created page with " ==Summary==

Description

The IFLOG call (LOGIN) identifies the user to Model 204 if a login is required.

Thread type

multiple cursor IFSTRT..."

2016-07-07T21:52:51Z

Created page with " ==Summary== <dl> <dt>Description</dt> <dd>The IFLOG call (LOGIN) identifies the user to Model 204 if a login is required.</dd> <dt>Thread type</dt> <dd>multiple cursor IFSTRT..."

New page

==Summary==
<dl>
<dt>Description</dt>
<dd>The IFLOG call (LOGIN) identifies the user to Model 204 if a login is required.</dd>
<dt>Thread type</dt>
<dd>multiple cursor IFSTRT, single cursor IFSTRT</dd>
<dt>IFCALL function number</dt>
<dd>Not applicable</dd>
</dl>

==Syntax==
IFLOG(RETCODE,LOGIN)

<dl>
<dt>Compile-only form</dt>
<dd>Not available</dd>
<dt>Execute-only form</dt>
<dd>Not available</dd>
</dl>

Specify the parameters in the syntax order shown above. 
<table>
<tr class="head">
<th>Parameter</th>
<th>Description</th>
</tr>
<tr>
<td>RETCODE</td>
<td>[O,i,r] The Model 204 return code is a required output parameter. The code is a binary integer value. See the following "Notes and tips" section for more information.</td>
</tr>
<tr>
<td>LOGIN</td>
<td>[I,c,r] The login information is a required parameter that supplies a valid Model 204 user ID and password that permit entry to the system. Specify the login as a character string using the following format:
userid [account]; password;

where:

<var class="term">userid</var> is required and is a character string that identifies the user who is logging into Model 204.

<var class="term">account</var> is an optional character string, from one to ten characters in length, that supplies an account under which the user is logging into Model 204.

<var class="term">password</var> is a character string that allows the specified user to access Model 204, and it is required unless an external security package is being used. See the following "Notes and tips" section for more information. 
</td>
</tr>
</table>

==Usage notes==

Use the IFLOG call to provide login information for an IFAM1 HLI application, as necessary. IFLOG is required in an IFAM1 program where the user authorization is to be validated by a security interface. 

Note: IFLOG is available for use only in IFAM1 using an IFSTRT thread. 

When an external security interface is performing login validation, Rocket Technical Support recommends the following:
<ul>
<li>Do not specify a user ID in the login for User 0. </li>
<li>If a user ID is supplied on the LOGIN command, it must match the user ID of the owner of the address space, or this user ID must exist on CCASTAT. Otherwise, the login fails. </li>
</ul>

When using an external security interface, do not code the password in the host language program unless the user ID exists on CCASTAT. In this case, if a password is encountered, Model 204 interprets IFLOG as an invalid command. 

==Completion return code (RETCODE)==

Model 204 returns either of the following completion codes for IFLOG:
<table>
<tr class="head">
<th>Code</th>
<th>Condition</th>
</tr>
<tr>
<td>0</td>
<td>Indicates that the login was successful.</td>
</tr>
<tr>
<td>100</td>
<td>Indicates that the login failed.</td>
</tr>
</table>

==Coding example (COBOL)==

The COBOL coding example below specifies the following IFLOG parameter arguments: login account name USERABC, and login password ECP. 
WORKING-STORAGE SECTION.
01 ARGS-FOR-CALL.
05 RETCODE PIC 9(5) COMP SYNC.
05 LOGIN PIC X(12) VALUE 'USERABC;ECP;'.
.
.
.
PROCEDURE DIVISION.
.
.
.
CALL "IFLOG" USING RETCODE, LOGIN.
IF RETCODE IS NOT EQUAL TO ZERO, GO TO ERROR-ROUTINE.
.
.
.

[[Category: HLI functions]]

IFLOG (HLI function) - Revision history

ELowell at 23:05, 12 July 2016

ELowell at 22:12, 11 July 2016

ELowell: Created page with " ==Summary== Description The IFLOG call (LOGIN) identifies the user to Model 204 if a login is required. Thread type multiple cursor IFSTRT..."

ELowell: Created page with " ==Summary==

Description

The IFLOG call (LOGIN) identifies the user to Model 204 if a login is required.

Thread type

multiple cursor IFSTRT..."