IFSTRTN (IFAM2) (HLI function) - Revision history

ELowell: /* Syntax */

2018-01-23T16:33:15Z

Syntax

← Older revision		Revision as of 16:33, 23 January 2018
Line 57:		Line 57:
	<p>		<p>
	<var class="term">password</var> is a character string that allows the specified user to access Model 204.</p>		<var class="term">password</var> is a character string that allows the specified user to access Model 204.</p>
			<p>As of Model 204 version 7.7: <br />Either a blank or a semicolon is accepted as the password delimiter. You can set the <var>[[CUSTOM parameter\|CUSTOM]]=24</var> option to allow embedded blanks within passwords. If you are using embedded blanks, you must indicate the end of the password with a semicolon.</p>
	<p>		<p>
	<var class="term">new password</var> is an optional character string that changes the login password for the specified user, for future logins. (Supported in Model 204 version 7.6 and earlier; see [[#Changing a login password\|Changing a login password]] for details.)</p>		<var class="term">new password</var> is an optional character string that changes the login password for the specified user, for future logins. (Supported in Model 204 version 7.6 and earlier; see [[#Changing a login password\|Changing a login password]] for details.)</p>

JAL: misc formatting

2018-01-16T16:43:41Z

misc formatting

← Older revision		Revision as of 16:43, 16 January 2018
Line 50:		Line 50:
	(This method of changing a password is supported in version 7.6 and earlier)</p>		(This method of changing a password is supported in version 7.6 and earlier)</p>
	<p>		<p>
	~~where~~:</p>		Where:</p>
	<p>		<p>
	<var class="term">userid</var> is a character string that identifies the user who is logging into Model 204.</p>		<var class="term">userid</var> is a character string that identifies the user who is logging into Model 204.</p>
	<p>		<p>
	<var class="term">account</var> is an optional character string that supplies an account under which the user is logging into Model 204. </p>		<var class="term">account</var> is an optional character string that supplies an account under which the user is logging into Model 204. </p>
	<p>		<p>
	<var class="term">password</var> is a character string that allows the specified user to access Model 204.</p>		<var class="term">password</var> is a character string that allows the specified user to access Model 204.</p>
	<p>		<p>
	<var class="term">new password</var> is an optional character string that changes the login password for the specified user, for future logins. (Supported in Model 204 version 7.6 and earlier; see [[#Changing a login password\|Changing a login password]] for details.)</p>		<var class="term">new password</var> is an optional character string that changes the login password for the specified user, for future logins. (Supported in Model 204 version 7.6 and earlier; see [[#Changing a login password\|Changing a login password]] for details.)</p>
	<p>		<p>
	Certain restrictions apply to login entries when using a security subsystem, such as [[Security Server (formerly RACF) interface\|Security Server (formerly RACF)]], to perform login validation. For details, see the topic for your [[:Category:Security interfaces\|security interface]]. </p>		Certain restrictions apply to login entries when using a security subsystem, such as [[Security Server (formerly RACF) interface\|Security Server (formerly RACF)]], to perform login validation. For details, see the topic for your [[:Category:Security interfaces\|security interface]]. </p>
Line 80:		Line 80:
	<tr>		<tr>
	<td>THRD_ID</td>		<td>THRD_ID</td>
	<td>[O,i,r] The thread identifier is a required output parameter. Specify an integer variable. Model 204 returns a value that may be referenced using the IFDTHRD and IFSTHRD calls for thread switching in multithreaded applications.</td>		<td>[O,i,r] The thread identifier is a required output parameter. Specify an integer variable. Model 204 returns a value that may be referenced using the IFDTHRD and IFSTHRD calls for thread switching in multithreaded applications.</td>
	</tr>		</tr>
	<tr>		<tr>
Line 99:		Line 99:
	Use the <var>IFSTRTN</var> call to establish an IFAM2 connection using a specific Host Language Interface Model 204 service program. <var>IFSTRTN</var> performs the same function as <var>[[IFSTRT (IFAM2/IFAM4) (HLI function)\|IFSTRT]]</var>. The <var>IFSTRTN</var> call includes a sixth parameter, which is not available with <var>IFSTRT</var> that is used to specify the communications channel name for the service program.</p>		Use the <var>IFSTRTN</var> call to establish an IFAM2 connection using a specific Host Language Interface Model 204 service program. <var>IFSTRTN</var> performs the same function as <var>[[IFSTRT (IFAM2/IFAM4) (HLI function)\|IFSTRT]]</var>. The <var>IFSTRTN</var> call includes a sixth parameter, which is not available with <var>IFSTRT</var> that is used to specify the communications channel name for the service program.</p>
	<p>		<p>
	For more information about CRAM (Cross Region Access Method) and Host Language Interface Model 204 service programs, see [[HLI: Job requirements#Communications facilities (CRAM or IUCV)\|Communications facilities (CRAM or IUCV)]] and [[HLI: IFAM2 CICS processing#CICS abend handling\|IFAM2 CICS abend handling]].</p>		For more information about CRAM (Cross Region Access Method) and Host Language Interface Model 204 service programs, see [[HLI: Job requirements#Communications facilities (CRAM or IUCV)\|Communications facilities (CRAM or IUCV)]] and [[HLI: IFAM2 CICS processing#CICS abend handling\|IFAM2 CICS abend handling]].
	<p class="note"><b>Note:</b> An IFAM2 job can be multithreaded. You can call IFSTRTN more than once in a job to establish multiple threads, but only one thread is currently active and, for single cursor IFSTRT threads, each thread has its own current file or group, current record set, and current record. </p>		</p>
			<p class="note"><b>Note:</b> An IFAM2 job can be multithreaded. You can call <var>IFSTRTN</var> more than once in a job to establish multiple threads, but only one thread is currently active and, for single cursor <var>IFSTRT</var> threads, each thread has its own current file or group, current record set, and current record. </p>
	<p>		<p>
	IFSTRTN uses IFSTRT protocols, and allows applications written in a host language to process against the Model 204 database using a the same class of HLI calls that are available with IFSTRT. You can start a single cursor or multiple cursor IFSTRT thread using the IFSTRTN call. </p>		<var>IFSTRTN</var> uses <var>IFSTRT</var> protocols, and allows applications written in a host language to process against the Model 204 database using a the same class of HLI calls that are available with <var>IFSTRT</var>. You can start a single cursor or multiple cursor <var>IFSTRT</var> thread using the <var>IFSTRTN</var> call. </p>
	<p>		<p>
	IFSTRT, together with IFFNSH, initiates [[HLI: Recovery and checkpoints#Automatic checkpointing: CPSORT\|CPSORT checkpointing]].</p>		<var>IFSTRT</var>, together with <var>IFFNSH</var>, initiates [[HLI: Recovery and checkpoints#Automatic checkpointing: CPSORT\|CPSORT checkpointing]].</p>

	===Changing a login password===		===Changing a login password===
	Changing a login password by specifying <var class="term">password</var>:<var class="term">new password</var> is supported in Model 204 version 7.5 or earlier, and in Model 204 version 7.6 if the PWDCOLON parameter is not set (see <var>[[PWDCOLON parameter\|PWDCOLON]]</var> for details).		<p>
	<p>As of Model 204 version 7.7, ~~colons are allowed in login passwords, so a colon is not recognized as a delimiter between passwords in~~ the ~~case of~~ <var class="term">password</var>:<var class="term">new password</var> ~~(see above) when changing~~ a ~~password~~. ~~Use~~ the <var>[[LOGINCP or LOGONCP command\|LOGINCP]]</var> command to change your password.</p>		Changing a login password by specifying <var class="term">password</var>:<var class="term">new password</var> is supported in Model 204 version 7.5 or earlier, and in Model 204 version 7.6 if the <var>PWDCOLON</var> parameter is not set (see <var>[[PWDCOLON parameter\|PWDCOLON]]</var> for details).
			</p>
			<p class="note"><b>Note:</b> Since colons are allowed in login passwords as of Model 204 version 7.7,
			the <var class="term">password</var>:<var class="term">new password</var> syntax is no longer valid because the colon is not recognized as a delimiter. Instead, use the <var>[[LOGINCP or LOGONCP command\|LOGINCP]]</var> command to change your password. </p>

	==Coding example (COBOL)==		==Coding example (COBOL)==

JDamon: Clarification on use of colons to change passwords

2018-01-13T00:33:10Z

Clarification on use of colons to change passwords

← Older revision		Revision as of 00:33, 13 January 2018
Line 108:		Line 108:
	===Changing a login password===		===Changing a login password===
	Changing a login password by specifying <var class="term">password</var>:<var class="term">new password</var> is supported in Model 204 version 7.5 or earlier, and in Model 204 version 7.6 if the PWDCOLON parameter is not set (see <var>[[PWDCOLON parameter\|PWDCOLON]]</var> for details).		Changing a login password by specifying <var class="term">password</var>:<var class="term">new password</var> is supported in Model 204 version 7.5 or earlier, and in Model 204 version 7.6 if the PWDCOLON parameter is not set (see <var>[[PWDCOLON parameter\|PWDCOLON]]</var> for details).
	<p>As of Model 204 version 7.7, colons are ~~always~~ allowed in login passwords, so a colon is not recognized as a delimiter between passwords. Use the <var>[[LOGINCP or LOGONCP command\|LOGINCP]]</var> command to change your password.</p>		<p>As of Model 204 version 7.7, colons are allowed in login passwords, so a colon is not recognized as a delimiter between passwords in the case of <var class="term">password</var>:<var class="term">new password</var> (see above) when changing a password. Use the <var>[[LOGINCP or LOGONCP command\|LOGINCP]]</var> command to change your password.</p>

	==Coding example (COBOL)==		==Coding example (COBOL)==

JAL: /* Usage notes */ add link

2017-03-31T00:46:38Z

Usage notes: add link

← Older revision		Revision as of 00:46, 31 March 2017
Line 97:		Line 97:
	==Usage notes==		==Usage notes==
	<p>		<p>
	Use the IFSTRTN call to establish an IFAM2 connection using a specific Host Language Interface Model 204 service program. IFSTRTN performs the same function as IFSTRT. The IFSTRTN call includes a sixth parameter, which is not available with IFSTRT that is used to specify the communications channel name for the service program.</p>		Use the <var>IFSTRTN</var> call to establish an IFAM2 connection using a specific Host Language Interface Model 204 service program. <var>IFSTRTN</var> performs the same function as <var>[[IFSTRT (IFAM2/IFAM4) (HLI function)\|IFSTRT]]</var>. The <var>IFSTRTN</var> call includes a sixth parameter, which is not available with <var>IFSTRT</var> that is used to specify the communications channel name for the service program.</p>
	<p>		<p>
	For more information about CRAM (Cross Region Access Method) and Host Language Interface Model 204 service programs, see [[HLI: Job requirements#Communications facilities (CRAM or IUCV)\|Communications facilities (CRAM or IUCV)]] and [[HLI: IFAM2 CICS processing#CICS abend handling\|IFAM2 CICS abend handling]].</p>		For more information about CRAM (Cross Region Access Method) and Host Language Interface Model 204 service programs, see [[HLI: Job requirements#Communications facilities (CRAM or IUCV)\|Communications facilities (CRAM or IUCV)]] and [[HLI: IFAM2 CICS processing#CICS abend handling\|IFAM2 CICS abend handling]].</p>

JAL: /* Usage notes */ add links

2017-02-27T21:11:51Z

Usage notes: add links

← Older revision		Revision as of 21:11, 27 February 2017
Line 99:		Line 99:
	Use the IFSTRTN call to establish an IFAM2 connection using a specific Host Language Interface Model 204 service program. IFSTRTN performs the same function as IFSTRT. The IFSTRTN call includes a sixth parameter, which is not available with IFSTRT that is used to specify the communications channel name for the service program.</p>		Use the IFSTRTN call to establish an IFAM2 connection using a specific Host Language Interface Model 204 service program. IFSTRTN performs the same function as IFSTRT. The IFSTRTN call includes a sixth parameter, which is not available with IFSTRT that is used to specify the communications channel name for the service program.</p>
	<p>		<p>
	For more information about CRAM (Cross Region Access Method) and Host Language Interface Model 204 service programs, see [[HLI: Job requirements]] and [[HLI: IFAM2 CICS processing]].</p>		For more information about CRAM (Cross Region Access Method) and Host Language Interface Model 204 service programs, see [[HLI: Job requirements#Communications facilities (CRAM or IUCV)\|Communications facilities (CRAM or IUCV)]] and [[HLI: IFAM2 CICS processing#CICS abend handling\|IFAM2 CICS abend handling]].</p>
	<p class="note"><b>Note:</b> An IFAM2 job can be multithreaded. You can call IFSTRTN more than once in a job to establish multiple threads, but only one thread is currently active and, for single cursor IFSTRT threads, each thread has its own current file or group, current record set, and current record. </p>		<p class="note"><b>Note:</b> An IFAM2 job can be multithreaded. You can call IFSTRTN more than once in a job to establish multiple threads, but only one thread is currently active and, for single cursor IFSTRT threads, each thread has its own current file or group, current record set, and current record. </p>
	<p>		<p>

JDamon: /* Syntax */

2017-01-27T18:43:08Z

Syntax

← Older revision		Revision as of 18:43, 27 January 2017
Line 86:		Line 86:
	<td>[I,c,r] The channel (CHAN) name (the value of the [[IFAMCHNL parameter]]) is a required input parameter that specifies the CRAM, IUCV, or VMCF communications channel name for a particular service program. Specify the name as an eight-character string.		<td>[I,c,r] The channel (CHAN) name (the value of the [[IFAMCHNL parameter]]) is a required input parameter that specifies the CRAM, IUCV, or VMCF communications channel name for a particular service program. Specify the name as an eight-character string.
	<p>		<p>
	The four-character, secondary subsystem name, SSNX, is optional. If present, the colon is a required delimiter. You can use it when you want to override the default value stored in IGCLM244.</p>		The four-character, secondary subsystem name, SSNX, is optional. If present, the colon is a required delimiter. You can use it when you want to override the default value stored in IGCLM244. See [[HLI: Job requirements#Subsystem names, channel names, and IODEV settings\|Subsystem names, channel names, and IODEV settings]] for defaults.
			</p>
	<p class="note"><b>Note:</b> Do <i>not</i> append a semicolon.</p>		<p class="note"><b>Note:</b> Do <i>not</i> append a semicolon.</p>
	<p>		<p>

JDamon: A little more tidy up on SSNX:CHAN

2017-01-27T18:34:46Z

A little more tidy up on SSNX:CHAN

← Older revision		Revision as of 18:34, 27 January 2017
Line 12:		Line 12:

	==Syntax==		==Syntax==
	<p class="syntax">IFSTRTN\|IFSTRN (RETCODE,LANG_IND,LOGIN,THRD_TYP,THRD_ID,[~~SSN~~:]CHAN)</p>		<p class="syntax">IFSTRTN\|IFSTRN (RETCODE,LANG_IND,LOGIN,THRD_TYP,THRD_ID,[SSNX:]CHAN)</p>

	<dl>		<dl>
Line 83:		Line 83:
	</tr>		</tr>
	<tr>		<tr>
	<td nowrap>[~~SSN~~:]CHAN</td>		<td nowrap>[SSNX:]CHAN</td>
	<td>[I,c,r] The channel (CHAN) name is a required input parameter that specifies the CRAM, IUCV, or VMCF communications channel name for a particular service program. Specify the name as an eight-character string.		<td>[I,c,r] The channel (CHAN) name (the value of the [[IFAMCHNL parameter]]) is a required input parameter that specifies the CRAM, IUCV, or VMCF communications channel name for a particular service program. Specify the name as an eight-character string.
	<p>		<p>
	The subsystem name ~~(SSN:)~~ is optional. You can use it when you want to override the default~~. Specify the name as a four-character string, plus colon (:)~~.</p>		The four-character, secondary subsystem name, SSNX, is optional. If present, the colon is a required delimiter. You can use it when you want to override the default value stored in IGCLM244.</p>
	<p class="note"><b>Note:</b> Do <i>not</i> append a semicolon.</p>		<p class="note"><b>Note:</b> Do <i>not</i> append a semicolon.</p>
	<p>		<p>

JAL: /* Syntax */ add blank

2017-01-27T16:00:37Z

Syntax: add blank

← Older revision		Revision as of 16:00, 27 January 2017
Line 12:		Line 12:

	==Syntax==		==Syntax==
	<p class="syntax">IFSTRTN\|IFSTRN(RETCODE,LANG_IND,LOGIN,THRD_TYP,THRD_ID,[SSN:]CHAN)</p>		<p class="syntax">IFSTRTN\|IFSTRN (RETCODE,LANG_IND,LOGIN,THRD_TYP,THRD_ID,[SSN:]CHAN)</p>

	<dl>		<dl>

ELowell at 21:32, 17 October 2016

2016-10-17T21:32:24Z

← Older revision		Revision as of 21:32, 17 October 2016
Line 12:		Line 12:

	==Syntax==		==Syntax==
	<p class="syntax">IFSTRTN\|IFSTRN(RETCODE,LANG_IND,LOGIN,THRD_TYP,THRD_ID,[~~SBSN~~:]CHAN)</p>		<p class="syntax">IFSTRTN\|IFSTRN(RETCODE,LANG_IND,LOGIN,THRD_TYP,THRD_ID,[SSN:]CHAN)</p>

	<dl>		<dl>
Line 83:		Line 83:
	</tr>		</tr>
	<tr>		<tr>
	<td nowrap>[~~SBSN~~:]CHAN</td>		<td nowrap>[SSN:]CHAN</td>
	<td>[I,c,r] The channel (CHAN) name is a required input parameter that specifies the CRAM, IUCV, or VMCF communications channel name for a particular service program. Specify the name as an eight-character string.		<td>[I,c,r] The channel (CHAN) name is a required input parameter that specifies the CRAM, IUCV, or VMCF communications channel name for a particular service program. Specify the name as an eight-character string.
	<p>		<p>
	The subsystem name (~~SBSN~~:) is optional. You can use it when you want to override the default. Specify the name as a four-character string, plus colon (:).</p>		The subsystem name (SSN:) is optional. You can use it when you want to override the default. Specify the name as a four-character string, plus colon (:).</p>
	<p class="note"><b>Note:</b> Do <i>not</i> append a semicolon.</p>		<p class="note"><b>Note:</b> Do <i>not</i> append a semicolon.</p>
	<p>		<p>

ELowell: /* Usage notes */

2016-10-11T20:58:13Z

Usage notes

← Older revision		Revision as of 20:58, 11 October 2016
Line 104:		Line 104:
	<p>		<p>
	IFSTRT, together with IFFNSH, initiates [[HLI: Recovery and checkpoints#Automatic checkpointing: CPSORT\|CPSORT checkpointing]].</p>		IFSTRT, together with IFFNSH, initiates [[HLI: Recovery and checkpoints#Automatic checkpointing: CPSORT\|CPSORT checkpointing]].</p>

			===Changing a login password===
			Changing a login password by specifying <var class="term">password</var>:<var class="term">new password</var> is supported in Model 204 version 7.5 or earlier, and in Model 204 version 7.6 if the PWDCOLON parameter is not set (see <var>[[PWDCOLON parameter\|PWDCOLON]]</var> for details).
			<p>As of Model 204 version 7.7, colons are always allowed in login passwords, so a colon is not recognized as a delimiter between passwords. Use the <var>[[LOGINCP or LOGONCP command\|LOGINCP]]</var> command to change your password.</p>

	==Coding example (COBOL)==		==Coding example (COBOL)==