CUSTOM parameter: Difference between revisions
m (CUSTOM=20 required a left/right slider at the bottom. Remove blanks to eliminate the slider.) |
mNo edit summary |
||
| Line 15: | Line 15: | ||
==Description== | ==Description== | ||
<p>The CUSTOM parameter enables special modifications by Rocket Software to standard execution. </p> | <p> | ||
<p>You do not have to enclose a single CUSTOM setting with parentheses, for example:</p> | The <var>CUSTOM</var> parameter enables special modifications by Rocket Software to standard execution. </p> | ||
<p> | |||
You do not have to enclose a single <var>CUSTOM</var> setting with parentheses, for example:</p> | |||
<p class="code">CUSTOM=8 | <p class="code">CUSTOM=8 | ||
</p> | </p> | ||
<p>Multiple values must be specified in a list and enclosed in parentheses, for example: </p> | <p> | ||
Multiple values must be specified in a list and enclosed in parentheses, for example: </p> | |||
<p class="code">CUSTOM=(1,2,3,4,6,8,9,10,11) | <p class="code">CUSTOM=(1,2,3,4,6,8,9,10,11) | ||
</p> | </p> | ||
<p>The current usages are: | <p> | ||
The current usages are: | |||
<table> | <table> | ||
<tr class="head"><th>Setting</th><th>Usage</th><th>Introduced in <br />Model 204</th></tr> | <tr class="head"><th>Setting</th><th>Usage</th><th>Introduced in <br />Model 204</th></tr> | ||
| Line 38: | Line 42: | ||
<tr><th><var>CUSTOM=(4)</var></th> | <tr><th><var>CUSTOM=(4)</var></th> | ||
<td><p class="syntax"><var>[[DISPLAY_FIELD_command|DISPLAY FIELD]]</var> <span class="term">fieldname</span></p> | <td><p class="syntax"><var>[[DISPLAY_FIELD_command|DISPLAY FIELD]]</var> <span class="term">fieldname</span></p> Defaults to: | ||
<p class="syntax">DISPLAY FIELD (DDL ABBREV) <span class="term">fieldname</span></p> | <p class="syntax">DISPLAY FIELD (DDL ABBREV) <span class="term">fieldname</span></p></td> | ||
</td> | |||
<td>V4.1</td></tr> | <td>V4.1</td></tr> | ||
| Line 54: | Line 57: | ||
<tr><th><var>CUSTOM=(7)</var></th> | <tr><th><var>CUSTOM=(7)</var></th> | ||
<td>Obsolete as of <var class="product">Model 204</var> | <td>Obsolete as of <var class="product">Model 204</var> V7.1.</td> | ||
<td>V5.1</td></tr> | <td>V5.1</td></tr> | ||
<tr><th><var>CUSTOM=(8)</var></th> | <tr><th><var>CUSTOM=(8)</var></th> | ||
<td><var class="product">Connect | <td><var class="product">Connect<span class="superstar">★</span></var> clients can issue the <var>[[LOGIN or LOGON command|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> | ||
<td>V6.1</td></tr> | <td>V6.1</td></tr> | ||
| Line 66: | Line 69: | ||
<tr><th nowrap><var>CUSTOM=(10)</var></th> | <tr><th nowrap><var>CUSTOM=(10)</var></th> | ||
<td>Allows | <td>Allows file name entry using more than eight characters.</td> | ||
<td>V7.4</td></tr> | <td>V7.4</td></tr> | ||
<tr><th><var>CUSTOM=(11)</var></th> | <tr><th><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> | <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> | ||
<td>V7.4</td></tr> | <td>V7.4</td></tr> | ||
| Line 94: | Line 97: | ||
<tr><th><var>CUSTOM=(17)</var></th> | <tr><th><var>CUSTOM=(17)</var></th> | ||
<td>Preserves plus sign (<tt>+</tt>) in ASA column 1 for VBA datasets and [[USE PRINTER / PUNCH command|USE PRINTER]] output to allow for overtyping. Line must contain plus sign in column 1, followed by blank, followed by anything: | <td>Preserves plus sign (<tt>+</tt>) in ASA column 1 for VBA datasets and <var>[[USE PRINTER / PUNCH command|USE PRINTER]]</var> output to allow for overtyping. Line must contain plus sign in column 1, followed by blank, followed by anything: | ||
<p class="code">PRINT '+ anything'</p> | <p class="code">PRINT '+ anything'</p> | ||
</td> | </td> | ||
| Line 105: | Line 108: | ||
<tr><th><var>CUSTOM=(19)</var></th> | <tr><th><var>CUSTOM=(19)</var></th> | ||
<td> | <td> | ||
Change the Login failed message from | Change the Login failed message from: | ||
<p class="code">M204.0349: Login failed | <p class="code">M204.0349: Login failed </p> | ||
<p> | |||
M204.0349: Enter logoff | To: </p> | ||
</p> | <p class="code">M204.0349: Enter logoff </p></td> | ||
</td> | |||
<td>V7.5; requires zap 75Z279</td></tr> | <td>V7.5; requires zap 75Z279</td></tr> | ||
<tr><th><var>CUSTOM=(20)</var></th> | <tr><th><var>CUSTOM=(20)</var></th> | ||
<td> | <td> | ||
Suppress the last line in the LOGCTL dialog during ADD, CHANGE and DELETE | Suppress the last line in the <var>LOGCTL</var> dialog during <var>ADD</var>, <var>CHANGE</var>, and <var>DELETE</var>. | ||
<p class="code"> LOGCTL C USER1 | <p class="code"> LOGCTL C USER1 | ||
*** M204.0374: ENTER PASSWORD,PRIVILEGES,PRIORITY | *** M204.0374: ENTER PASSWORD,PRIVILEGES,PRIORITY | ||
*** M204.0379: Enter terminal list, all, none, add, del, or return | *** M204.0379: Enter terminal list, all, none, add, del, or return | ||
USER1 X'10' LOW ALL <b><--------suppress this line</b> | USER1 X'10' LOW ALL <b><--------suppress this line</b> | ||
*** M204.0376: Parameters accepted | *** M204.0376: Parameters accepted | ||
*** M204.0345: CCASTAT updated | *** M204.0345: CCASTAT updated | ||
</p> | </p> | ||
</td> | </td> | ||
| Line 129: | Line 131: | ||
<tr><th><var>CUSTOM=(21)</var></th> | <tr><th><var>CUSTOM=(21)</var></th> | ||
<td> | <td> | ||
FILELOAD; skip DDname check for CCA1WK01 to allow DFSORT to dynamically allocate sort work datasets. | <var>FILELOAD</var>; skip DDname check for <code>CCA1WK01</code> to allow DFSORT to dynamically allocate sort work datasets. DFSORT will dynamically allocate CCA1WK01-CCA1WK06 unless overridden by <code>//DFSPARM</code>: | ||
<p class="code">//DFSPARM DD * | <p class="code">//DFSPARM DD * | ||
// SIZE=200M,LIST,LISTX,MSGPRT=ALL,FILSZ=E1800000 | // SIZE=200M,LIST,LISTX,MSGPRT=ALL,FILSZ=E1800000 | ||
// OPTION DYNALLOC=(SYSDA,3) <b><------will override</b> | // OPTION DYNALLOC=(SYSDA,3) <b><------will override</b></p></td> | ||
</p> | |||
</td> | |||
<td>V7.5; requires zap 75Z279</td></tr> | <td>V7.5; requires zap 75Z279</td></tr> | ||
<tr><th><var>CUSTOM=(22)</var></th> | <tr><th><var>CUSTOM=(22)</var></th> | ||
<td> | <td>Use BATCH204 return codes if <var>NUSERS</var> is greater than 1.</td> | ||
Use BATCH204 return codes | |||
<td>V7.5; requires zap 75Z279</td></tr> | <td>V7.5; requires zap 75Z279</td></tr> | ||
<tr><th><var>CUSTOM=(31)</var></th> | <tr><th><var>CUSTOM=(31)</var></th> | ||
<td>Extra bug checks for | <td>Extra bug checks for Ordered Index leaf pages.</td> | ||
<td>V7.5</td></tr> | <td>V7.5</td></tr> | ||
<tr><th><var>CUSTOM=(32)</var></th> | <tr><th><var>CUSTOM=(32)</var></th> | ||
<td>Extra bug checks for all | <td>Extra bug checks for all Ordered Index pages.</td> | ||
<td>V7.5</td></tr> | <td>V7.5</td></tr> | ||
| Line 185: | Line 184: | ||
====Using the CUSTOM=(1) parameter with date conversions==== | ====Using the CUSTOM=(1) parameter with date conversions==== | ||
<p>If <code>CUSTOM=(1)</code> is added to the User 0 CCAIN stream or set later using the <var>[[RESET_command|RESET]]</var> 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> | <p> | ||
If <code>CUSTOM=(1)</code> is added to the User 0 CCAIN stream or set later using the <var>[[RESET_command|RESET]]</var> command, the following occurs: If a <code>CYY</code> format is specified for conversion and only a <code>YY</code> 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> | ||
If CUSTOM=1, BASECENT=19, and CENTSPLT=95, then: | If <code>CUSTOM=1</code>, <code>BASECENT=19</code>, and <code>CENTSPLT=95</code>, then: | ||
<table> | <table> | ||
<tr class="head"><th>Print command</th> <th>Results</th></tr> | <tr class="head"><th>Print command</th> <th>Results</th></tr> | ||
| Line 198: | Line 198: | ||
</table> | </table> | ||
If CUSTOM=1 is omitted, BASECENT=19, and CENTSPLT=95, then: | If <code>CUSTOM=1</code> is omitted, <code>BASECENT=19</code>, and <code>CENTSPLT=95</code>, then: | ||
<table> | <table> | ||
<tr class="head"><th>Print command</th> <th>Results</th></tr> | <tr class="head"><th>Print command</th> <th>Results</th></tr> | ||
| Line 208: | Line 208: | ||
====Using CUSTOM=(2)==== | ====Using CUSTOM=(2)==== | ||
If <code>CUSTOM=(2)</code> is added to the User 0 CCAIN stream or set later using the <var>RESET</var> 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. | If <code>CUSTOM=(2)</code> is added to the User 0 CCAIN stream or set later using the <var>RESET</var> command, the following occurs: If a <code>CYY</code>-format is specified for output conversion and the <code>C</code> (century) indicator is zero, then <code>C</code> is eliminated. This <code>C</code> elimination is true for all $DATE… function calls. | ||
For example: | For example: | ||
If CUSTOM=(2) then: <code>PRINT $DATEJ(2)</code> prints <code>97.001</code> | If <code>CUSTOM=(2)</code> then: <code>PRINT $DATEJ(2)</code> prints <code>97.001</code> | ||
But if CUSTOM=(2) is omitted, then <code>PRINT $DATEJ(2)</code> prints <code>097.001</code>. | But if <code>CUSTOM=(2)</code> is omitted, then <code>PRINT $DATEJ(2)</code> prints <code>097.001</code>. | ||
====Using CUSTOM=(6)==== | ====Using CUSTOM=(6)==== | ||
| Line 225: | Line 225: | ||
====Using CUSTOM=(8)==== | ====Using CUSTOM=(8)==== | ||
The <code>CUSTOM=(8)</code> option lets Connect | The <code>CUSTOM=(8)</code> option lets Connect<span class="superstar">★</span> customers use one connection for multiple users. | ||
<ul> | <ul> | ||
<li>If <code>CUSTOM=(8)</code> is not set, RCL behaves as in releases of Model 204 before V6R1.0; users receive the following message when issuing the <var>LOGIN</var> command: | <li>If <code>CUSTOM=(8)</code> is not set, RCL behaves as in releases of Model 204 before V6R1.0; users receive the following message when issuing the <var>LOGIN</var> command: | ||
<p><code>M204.1035:COMMAND INVALID FROM PROCEDURE</code></p></li> | <p> | ||
<code>M204.1035:COMMAND INVALID FROM PROCEDURE</code></p></li> | |||
<li>If <code>CUSTOM=(8)</code> is set, any commands that are invalid for RCL receive the following message: | <li>If <code>CUSTOM=(8)</code> is set, any commands that are invalid for RCL receive the following message: | ||
<p><code>M204.2597 command COMMAND INVALID FROM AN RCL THREAD</code></p> | <p> | ||
<code>M204.2597 command COMMAND INVALID FROM AN RCL THREAD</code></p> | |||
</li> | </li> | ||
</ul> | </ul> | ||
Revision as of 19:58, 17 February 2015
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 | Introduced in Model 204 |
|---|---|---|
| CUSTOM=(1) | Century can be omitted on date input. | V4.1 |
| CUSTOM=(2) | Century is omitted on date output. | V4.1 |
| CUSTOM=(3) | $DAYI should return day values 2 through 8 (instead of 1 through 7). $DAY should equate values 2 through 8 as Monday through Sunday, and full-length day names should be returned. Value 9 returns MON-FRI. |
V4.1 |
| CUSTOM=(4) | DISPLAY FIELD fieldname Defaults to:DISPLAY FIELD (DDL ABBREV) fieldname |
V4.1 |
| CUSTOM=(5) | Print debugging information for all MQ/204 requests. | V4.2 |
| CUSTOM=(6) | The LOGOUT message is:
M204.2628: uuuuuuuuuu aaaaaaaaaa LOGOUT yy mmm dd hh.mm |
V5.1 |
| CUSTOM=(7) | Obsolete as of Model 204 V7.1. | V5.1 |
| 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. | V6.1 |
| CUSTOM=(9) | Suppresses all output from all forms of the PRIORITY command. | V7.1 |
| CUSTOM=(10) | Allows file name entry using more than eight characters. | V7.4 |
| 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. | V7.4 |
| CUSTOM=(12) | Swap order of system manager and system administrator test with external authorizer. Only available in Model 204 V7.5 and later. | V7.5 |
| CUSTOM=(13) | Close VSAM files even if CLOSE=EOJ specified. |
V7.5 |
| CUSTOM=(14) | Require account ID (in addition to userid) on logins. | V7.5 |
| CUSTOM=(15) | Don't display user number on console (WTO) messages. | V7.5 |
| CUSTOM=(16) | Append the userid of the updating user to the date-time stamp (DTSFN) field values. | V7.5 |
| CUSTOM=(17) | Preserves plus sign (+) in ASA column 1 for VBA datasets and USE PRINTER output to allow for overtyping. Line must contain plus sign in column 1, followed by blank, followed by anything:
PRINT '+ anything' |
V7.5 |
| CUSTOM=(18) | Allow the SSLIBSIZE (JANUS DEFINE parameter) to be set to a value greater than 16K (16384). | V7.5 |
| CUSTOM=(19) |
Change the Login failed message from: M204.0349: Login failed To: M204.0349: Enter logoff |
V7.5; requires zap 75Z279 |
| CUSTOM=(20) |
Suppress the last line in the LOGCTL dialog during ADD, CHANGE, and DELETE. LOGCTL C USER1 *** M204.0374: ENTER PASSWORD,PRIVILEGES,PRIORITY *** M204.0379: Enter terminal list, all, none, add, del, or return USER1 X'10' LOW ALL <--------suppress this line *** M204.0376: Parameters accepted *** M204.0345: CCASTAT updated |
V7.5; requires zap 75Z279 |
| CUSTOM=(21) |
FILELOAD; skip DDname check for //DFSPARM DD * // SIZE=200M,LIST,LISTX,MSGPRT=ALL,FILSZ=E1800000 // OPTION DYNALLOC=(SYSDA,3) <------will override |
V7.5; requires zap 75Z279 |
| CUSTOM=(22) | Use BATCH204 return codes if NUSERS is greater than 1. | V7.5; requires zap 75Z279 |
| CUSTOM=(31) | Extra bug checks for Ordered Index leaf pages. | V7.5 |
| CUSTOM=(32) | Extra bug checks for all Ordered Index pages. | V7.5 |
| CUSTOM=(33) | Issue a message (M204.1223) for every critical file resource wait. | V7.5 |
| CUSTOM=(34) | Suppress APSY load stats from the journal. | V7.5 |
| CUSTOM=(35) | Do not drain a subsystem when a user encounters a hard restart inside the subsystem. | V7.5 |
| CUSTOM=(36) | An Insert statement with occurrence number 0 should place the inserted occurrence at the start of repeatable fields in the record. | V7.5 |
| CUSTOM=(37) | Change M204.1076 (Do you really want to end the run) to indicate the job name rather than the location. | V7.5 |
| CUSTOM=(38) | Allow any (non-privileged) user to reset LAUDIT. | V7.5 |
| CUSTOM=(39) | Echo any MSGCTL command in a M204.0131 message. | V7.5 |
| CUSTOM=(40) | Allow field constraints (UNIQUE, At-MOST-ONE) in non-TBO (FRCVOPT X'08' bit on) files. | V7.5 |
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 NOTERMis 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 6, 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
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
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 external 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.
Using CUSTOM=(18)
Before Model 204 7.5, a setting of greater than 16K (16384) was allowed for the SSLIBSIZE (JANUS DEFINE parameter). However, in theory this should have only been necessary for SSL 2 support, as SSL 3 and TLS compliant implementations should only use SSL records of 16K or shorter. Since support for SSL 2 has been disabled in Model 204 7.5 (because SSL 2 is deprecated for its many security flaws), there is seemingly no need for SSL buffers longer than the 16K limit. So, Model 204 7.5 reduces any value greater than 16K for SSLBSIZE and SSLIBSIZE to 16K. This prevents model 204 from pointlessly allocating more storage than is necessary for SSL buffers.
However, it appears that there are a few SSL 3 and TLS implementations in use that send SSL records longer than 16K, despite the standard's proscription against doing so. If a site communicates with such implementations, it might be necessary to set CUSTOM 18, then set SSLIBSIZE (or SSLBSIZE) to a value greater than 16K.