CUSTOM parameter: Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
|||
| Line 13: | Line 13: | ||
<dd><var class="product">Model 204 V6.1</var> or earlier | <dd><var class="product">Model 204 V6.1</var> or earlier | ||
</dl> | </dl> | ||
==Description== | ==Description== | ||
<p>The CUSTOM parameter enables special modifications by Rocket Software to standard execution. </p> | <p>The CUSTOM parameter enables special modifications by Rocket Software to standard execution. </p> | ||
| Line 23: | Line 24: | ||
<p>The current usages are: | <p>The current usages are: | ||
<table> | <table> | ||
<tr><th>Setting</th><th>Usage</th></tr> | <tr class="head"><th>Setting</th><th>Usage</th></tr> | ||
<tr><th><var>CUSTOM=(1)</var></th><td>Century can be omitted on date input</td></tr> | <tr><th><var>CUSTOM=(1)</var></th> | ||
<tr><th><var>CUSTOM=(2)</var></th><td>Century is omitted on date output</td></tr> | <td>Century can be omitted on date input.</td></tr> | ||
<tr><th><var>CUSTOM=(3)</var></th><td>$DAYI should return day values 2 through 8. $DAY should equate | |||
<tr><th><var>CUSTOM=(4)</var></th><td>Display field defaults to DDL ABBREV</td></tr> | <tr><th><var>CUSTOM=(2)</var></th> | ||
<tr><th nowrap><var>CUSTOM=(5)</var></th><td>Print debugging information for all MQ/204 requests.</td></tr> | <td>Century is omitted on date output.</td></tr> | ||
<tr><th><var>CUSTOM=(6)</var></th><td>The LOGOUT message is: | |||
<tr><th><var>CUSTOM=(3)</var></th> | |||
<td><var>[[$DAYI parameter|$DAYI]]</var> should return day values 2 through 8. <var>[[$DAY parameter|$DAY]]</var> should equate values 2 through 8 as Monday through Sunday, and full-length day names should be returned. Value 9 returns <code>MON-FRI</code>.</td></tr> | |||
<tr><th><var>CUSTOM=(4)</var></th> | |||
<td>Display field defaults to <code>DDL ABBREV</code>.</td></tr> | |||
<tr><th nowrap><var>CUSTOM=(5)</var></th> | |||
<td>Print debugging information for all MQ/204 requests.</td></tr> | |||
<tr><th><var>CUSTOM=(6)</var></th> | |||
<td>The <var>LOGOUT</var> message is: | |||
<p class="code">M204.2628: <var class="term">uuuuuuuuuu aaaaaaaaaa</var> LOGOUT <var class="term">yy mmm dd hh.mm</var> | <p class="code">M204.2628: <var class="term">uuuuuuuuuu aaaaaaaaaa</var> LOGOUT <var class="term">yy mmm dd hh.mm</var> | ||
</p></td></tr> | </p></td></tr> | ||
<tr><th><var>CUSTOM=(7)</var></th><td>Obsolete as of <var class="product">Model 204</var> V7R1.0.</td></tr> | |||
<tr><th><var>CUSTOM=(8)</var></th><td>Connect:clients can issue the LOGIN command from Remote Command Line (RCL) threads. Clients can login with a new user name without closing the current connection to start another one.</td></tr> | <tr><th><var>CUSTOM=(7)</var></th> | ||
<tr><th><var>CUSTOM=(9)</var></th><td>Suppresses all output from all forms of the PRIORITY command</td></tr> | <td>Obsolete as of <var class="product">Model 204</var> V7R1.0.</td></tr> | ||
<tr><th nowrap><var>CUSTOM=(10)</var></th><td>Allows filename entry using more than eight characters</td></tr> | |||
<tr><th nowrap><var>CUSTOM=(11)</var></th><td>Controls mixed case password support. If it is set, then mixed case passwords are allowed for both external and CCASTAT security. If it is not set, all passwords are uppercase.</td></tr> | <tr><th><var>CUSTOM=(8)</var></th> | ||
<tr><th nowrap><var>CUSTOM=(12)</var></th><td>Swap order of system manager and system administrator test with external authorizer. Only available in Model 204 7.5 and later.</td></tr> | <td>Connect:clients can issue the <var>LOGIN</var> command from Remote Command Line (RCL) threads. Clients can login with a new user name without closing the current connection to start another one.</td></tr> | ||
<tr><th nowrap><var>CUSTOM=(13)</var></th><td>Close VSAM files even if CLOSE=EOJ specified.</td></tr> | |||
<tr><th nowrap><var>CUSTOM=(14)</var></th><td>Require account id (in addition to userid) on logins.</td></tr> | <tr><th><var>CUSTOM=(9)</var></th> | ||
<tr><th nowrap><var>CUSTOM=(15)</var></th><td>Don't display user number on console (WTO) messages.</td></tr> | <td>Suppresses all output from all forms of the PRIORITY command</td></tr> | ||
<tr><th nowrap><var>CUSTOM=(31)</var></th><td>Extra bug checks for ordered index leaf pages.</td></tr> | |||
<tr><th nowrap><var>CUSTOM=(32)</var></th><td>Extra bug checks for all ordered index pages.</td></tr> | <tr><th nowrap><var>CUSTOM=(10)</var></th> | ||
<tr><th nowrap><var>CUSTOM=(33)</var></th><td>Issue a message (M204.1223) for every critical file resource wait.</td></tr> | <td>Allows filename entry using more than eight characters</td></tr> | ||
<tr><th nowrap><var>CUSTOM=(34)</var></th><td>Suppress APSY load stats from the journal.</td></tr> | |||
<tr><th nowrap><var>CUSTOM=(35)</var></th><td>Do not drain a subsystem when a user encounters a hard restart inside the subsystem.</td></tr> | <tr><th nowrap><var>CUSTOM=(11)</var></th> | ||
<tr><th nowrap><var>CUSTOM=(36)</var></th><td>An Insert statement with occurrence number 0 should place the inserted occurrence at the start of repeatable fields in the record.</td></tr> | <td>Controls mixed case password support. If it is set, then mixed case passwords are allowed for both external and CCASTAT security. If it is not set, all passwords are uppercase.</td></tr> | ||
<tr><th nowrap><var>CUSTOM=(37)</var></th><td>Change M204.1076 (Do you really want to end the run) to indicate the job name rather than the location.</td></tr> | |||
<tr><th nowrap><var>CUSTOM=(38)</var></th><td>Allow any (non-privileged) user to reset LAUDIT.</td></tr> | <tr><th nowrap><var>CUSTOM=(12)</var></th> | ||
<tr><th nowrap><var>CUSTOM=(39)</var></th><td>Echo any MSGCTL command in a M204.0131 message.</td></tr> | <td>Swap order of system manager and system administrator test with external authorizer. Only available in Model 204 7.5 and later.</td></tr> | ||
<tr><th nowrap><var>CUSTOM=(40)</var></th><td>Allow field constraints (UNIQUE, At-MOST-ONE) in non-TBO (FRCVOPT X'08' on) files.</td></tr> | |||
<tr><th nowrap><var>CUSTOM=(13)</var></th> | |||
<td>Close VSAM files even if CLOSE=EOJ specified.</td></tr> | |||
<tr><th nowrap><var>CUSTOM=(14)</var></th> | |||
<td>Require account id (in addition to userid) on logins.</td></tr> | |||
<tr><th nowrap><var>CUSTOM=(15)</var></th> | |||
<td>Don't display user number on console (WTO) messages.</td></tr> | |||
<tr><th nowrap><var>CUSTOM=(31)</var></th> | |||
<td>Extra bug checks for ordered index leaf pages.</td></tr> | |||
<tr><th nowrap><var>CUSTOM=(32)</var></th> | |||
<td>Extra bug checks for all ordered index pages.</td></tr> | |||
<tr><th nowrap><var>CUSTOM=(33)</var></th> | |||
<td>Issue a message (M204.1223) for every critical file resource wait.</td></tr> | |||
<tr><th nowrap><var>CUSTOM=(34)</var></th> | |||
<td>Suppress APSY load stats from the journal.</td></tr> | |||
<tr><th nowrap><var>CUSTOM=(35)</var></th> | |||
<td>Do not drain a subsystem when a user encounters a hard restart inside the subsystem.</td></tr> | |||
<tr><th nowrap><var>CUSTOM=(36)</var></th> | |||
<td>An Insert statement with occurrence number 0 should place the inserted occurrence at the start of repeatable fields in the record.</td></tr> | |||
<tr><th nowrap><var>CUSTOM=(37)</var></th> | |||
<td>Change M204.1076 (Do you really want to end the run) to indicate the job name rather than the location.</td></tr> | |||
<tr><th nowrap><var>CUSTOM=(38)</var></th> | |||
<td>Allow any (non-privileged) user to reset LAUDIT.</td></tr> | |||
<tr><th nowrap><var>CUSTOM=(39)</var></th> | |||
<td>Echo any MSGCTL command in a M204.0131 message.</td></tr> | |||
<tr><th nowrap><var>CUSTOM=(40)</var></th> | |||
<td>Allow field constraints (UNIQUE, At-MOST-ONE) in non-TBO (FRCVOPT X'08' on) files.</td></tr> | |||
</table> | </table> | ||
</p> | </p> | ||
====Using the CUSTOM=(1) parameter with date conversions==== | ====Using the CUSTOM=(1) parameter with date conversions==== | ||
<p>If CUSTOM=(1) is added to the User 0 CCAIN stream or set later using the RESET command, the following occurs: If a CYY format is specified for conversion and only a YY input is supplied, the conversion is successfully completed by using the CENTSPLT and BASECENT parameters.</p> | <p>If CUSTOM=(1) is added to the User 0 CCAIN stream or set later using the RESET command, the following occurs: If a CYY format is specified for conversion and only a YY input is supplied, the conversion is successfully completed by using the <var>[[CENTSPLT parameter|CENTSPLT]]</var> and <var>[[BASECENT parameter|BASECENT]]</var> parameters.</p> | ||
<b>Examples</b> | <b>Examples</b> | ||
Revision as of 23:07, 30 December 2013
Enable special modifications to Model 204
Summary
- Default value
- None
- Parameter type
- System
- Where set
- On User 0's parameter line or reset by the system manager
- Related products
- All
- Introduced
- Model 204 V6.1 or earlier
Description
The CUSTOM parameter enables special modifications by Rocket Software to standard execution.
You do not have to enclose a single CUSTOM setting with parentheses, for example:
CUSTOM=8
Multiple values must be specified in a list and enclosed in parentheses, for example:
CUSTOM=(1,2,3,4,6,8,9,10,11)
The current usages are:
| Setting | Usage |
|---|---|
| CUSTOM=(1) | Century can be omitted on date input. |
| CUSTOM=(2) | Century is omitted on date output. |
| CUSTOM=(3) | $DAYI should return day values 2 through 8. $DAY should equate values 2 through 8 as Monday through Sunday, and full-length day names should be returned. Value 9 returns MON-FRI. |
| CUSTOM=(4) | Display field defaults to DDL ABBREV. |
| CUSTOM=(5) | Print debugging information for all MQ/204 requests. |
| CUSTOM=(6) | The LOGOUT message is:
M204.2628: uuuuuuuuuu aaaaaaaaaa LOGOUT yy mmm dd hh.mm |
| CUSTOM=(7) | Obsolete as of Model 204 V7R1.0. |
| CUSTOM=(8) | Connect:clients can issue the LOGIN command from Remote Command Line (RCL) threads. Clients can login with a new user name without closing the current connection to start another one. |
| CUSTOM=(9) | Suppresses all output from all forms of the PRIORITY command |
| CUSTOM=(10) | Allows filename entry using more than eight characters |
| CUSTOM=(11) | Controls mixed case password support. If it is set, then mixed case passwords are allowed for both external and CCASTAT security. If it is not set, all passwords are uppercase. |
| CUSTOM=(12) | Swap order of system manager and system administrator test with external authorizer. Only available in Model 204 7.5 and later. |
| CUSTOM=(13) | Close VSAM files even if CLOSE=EOJ specified. |
| CUSTOM=(14) | Require account id (in addition to userid) on logins. |
| CUSTOM=(15) | Don't display user number on console (WTO) messages. |
| CUSTOM=(31) | Extra bug checks for ordered index leaf pages. |
| CUSTOM=(32) | Extra bug checks for all ordered index pages. |
| CUSTOM=(33) | Issue a message (M204.1223) for every critical file resource wait. |
| CUSTOM=(34) | Suppress APSY load stats from the journal. |
| CUSTOM=(35) | Do not drain a subsystem when a user encounters a hard restart inside the subsystem. |
| CUSTOM=(36) | An Insert statement with occurrence number 0 should place the inserted occurrence at the start of repeatable fields in the record. |
| CUSTOM=(37) | Change M204.1076 (Do you really want to end the run) to indicate the job name rather than the location. |
| CUSTOM=(38) | Allow any (non-privileged) user to reset LAUDIT. |
| CUSTOM=(39) | Echo any MSGCTL command in a M204.0131 message. |
| CUSTOM=(40) | Allow field constraints (UNIQUE, At-MOST-ONE) in non-TBO (FRCVOPT X'08' on) files. |
Using the CUSTOM=(1) parameter with date conversions
If CUSTOM=(1) is added to the User 0 CCAIN stream or set later using the RESET command, the following occurs: If a CYY format is specified for conversion and only a YY input is supplied, the conversion is successfully completed by using the CENTSPLT and BASECENT parameters.
Examples
IF CUSTOM=1, BASECENT=19, and CENTSPLT=95, then:
| Print Command | Results |
|---|---|
| PRINT $DATECNV('CYYDDD','YYYYMMDD','96001' | 19960101 |
| PRINT $DATECNV('CYYDDD','YYYYMMDD','196001' | 20960101 |
| PRINT $DATECNV('CYYDDD','YYYYMMDD','95001' | 19950101 |
| PRINT $DATECNV('CYYDDD','YYYYMMDD','095001' | 19950101 |
If CUSTOM=1 is omitted, BASECENT=19, and CENTSPLT=95, then:
| Print Command | Results |
|---|---|
| PRINT $DATECNV('CYYDDD','YYYYMMDD','96001' | ****** |
| PRINT $DATECNV('CYYDDD','YYYYMMDD','196001' | 20960101 |
| PRINT $DATECNV('CYYDDD','YYYYMMDD','95001' | ****** |
| PRINT $DATECNV('CYYDDD','YYYYMMDD','095001' | 19950101 |
Using CUSTOM=(2)
If CUSTOM=(2) is added to the User 0 CCAIN stream or set later using the RESET command, the following occurs: If a CYY-format is specified for output conversion and the C (century) indicator is zero, then C is eliminated. This C elimination is true for all $DATE… function calls.
For example:
If CUSTOM=(2) then: PRINT $DATEJ(2) prints 97.001
But if CUSTOM=(2) is omitted, then PRINT $DATEJ(2) prints 097.001.
Using CUSTOM=(6)
Using this option you can control the messages for the LOGIN and LOGOUT commands independently.
- When CUSTOM is not set to 6, BATCH2 and IFAM2 applications cannot receive the return code from Model 204, if the command MSGCTL M204.0353 NOTERM is issued in the Online. Model 204 sends the return code to BATCH2 and IFAM2 User Language applications as a hidden field in the LOGOUT message, and the application must receive the LOGOUT message to obtain the return code.
- When CUSTOM is set to six, you can suppress M204.0353 and leave M204.2628 active and available for a BATCH2 or IFAM2 User Language application to receive the return code from the Online.
Using CUSTOM=8
The CUSTOM=(8) option lets Connect* customers use one connection for multiple users.
- If the CUSTOM=(8) is not set, RCL behaves as in releases of Model 204 before V6R1.0; users receive the following message when issuing the LOGIN command:
M204.1035:COMMAND INVALID FROM PROCEDURE - If the CUSTOM=(8) is set, any commands that are invalid for RCL receive the following message:
M204.2597 command COMMAND INVALID FROM AN RCL THREAD
Using CUSTOM=(9)
The CUSTOM=(9) option lets you suppress all output from all forms of the PRIORITY command.
Using CUSTOM=(10)
Including CUSTOM=10 in the CCAIN parameter stream enables you to specify a DDNAME longer than eight characters. The first eight characters will be used.
Using CUSTOM=(11)
Including CUSTOM=11 in the CCAIN parameter stream enables you to specify passwords containing lowercase characters:
//CCAIN DD *
LOGADD=200,CUSTOM=11
Using CUSTOM=(12)
When using an external authorizer (RACF, ACF2, Top Secret) if a user issues a command that requires either system manager or system administrator privileges, Model 204 will test for system manager privileges for the logged in user using the extrenal authorizer and, if that fails, test for system administrator privileges. CUSTOM=(12) changes the order of the tests in such a case so that a user is tested for system administrator privileges before being tested for system manager privileges.