XDMSSN parameter: Difference between revisions
Jump to navigation
Jump to search
m (→Description: misc formatting) |
|||
| (6 intermediate revisions by 3 users not shown) | |||
| Line 4: | Line 4: | ||
<dl> | <dl> | ||
<dt>Default value | <dt>Default value | ||
<dd>Current setting of the z/OS subsystem name linked into the IGCLM244 (CRAM) module | <dd>Current setting of the z/OS subsystem name linked into the [[Cross-memory_facilities_CRAM_and_M204XSVC#Component_modules|IGCLM244]] (CRAM) module | ||
<dt>Parameter type | <dt>Parameter type | ||
<dd>System | <dd>System | ||
| Line 17: | Line 17: | ||
==Description== | ==Description== | ||
<p> | <p> | ||
The <var>XDMSSN</var> parameter | The <var>XDMSSN</var> parameter is available only for z/OS with [[Defining the user environment (CCAIN)#CRAM options for z.2FOS|CRAM-XDM]]. </p> | ||
<p> | <p> | ||
The <var>XDMSSN</var> parameter passes a z/OS secondary subsystem name that overrides the value stored in the CRAM IGCLM244 module. That value, a maximum of four characters, is initially specified [[Model 204 CRAM link job stream for IBM z/OS|during CRAM installation]].</p> | |||
<p> | <p> | ||
The subsystem name stored in IGCLM244 can also be overridden by BATCH2 or IFAM2 jobs as shown in the following examples: | Example: <code>XDMSSN=SS03</code> </p> | ||
<p> | |||
On the client side, the <var>XDMSSN</var> parameter applies to the following <var>[[IODEV parameter|IODEV]]</var> threads and can be in the form:</p> | |||
<p class="syntax"><span class="term">subsystem</span>:<span class="term">channel</span></p> | |||
<p> | |||
where <var class="term">subsystem</var> is a 4-character name, separated by a colon (:) from <var class="term">channel</var>, which is an 8-character name. </p> | |||
<table> | |||
<tr class="head"><th>IODEV thread</th> <th>Example or discussion</th></tr> | |||
<tr><td>11</td> <td><p class="code">TSO: CALL ’DSN(M204FS)’ ’M204:M204FULL’ | |||
CICS: M204 M204:M204FULL DATA logon ''userid''</p></td></tr> | |||
<tr><td>13</td> | |||
<td>Passed as part of the SQLConnect CLI function call via server name</td></tr> | |||
<tr><td>23</td> | |||
<td>Passed as part of the <var>[[IFSTRTN_(IFAM2)_(HLI_function)|IFSTRTN]]</var> (see example below)</td></tr> | |||
<tr><td>29</td> | |||
<td>Passed as part of the <var>[[IFDIALN_(HLI_function)|IFDIALN]]</var> call with the <var>CHAN</var> parameter and [[BATCH2 (CRAM)#BATCH2|BATCH2]] (see example below)</td></tr> | |||
</table> | |||
<p> | |||
The subsystem name stored in IGCLM244 can also be overridden by BATCH2 or [[HLI: Job design factors#IFAM2|IFAM2]] jobs as shown in the following examples: | |||
</p> | </p> | ||
<ul> | <ul> | ||
<li>[[Program Communication facilities]]: | <li>[[Program Communication facilities]]: | ||
<p class="code">//BATCH2 EXEC PGM=BATCH2,PARM='[<i><b>ssn</b>:channel</i>][,[OMC={X''hh'' | ''ddd''}] [,URCTYPE={N | O | B}]]' </p></li> | <p class="code">//BATCH2 EXEC PGM=BATCH2,PARM='[<i><b>ssn</b>:channel</i>][,[OMC={X''hh''|''ddd''}] [,URCTYPE={N|O|B}]]' </p></li> | ||
<li>[[IFSTRTN (IFAM2) (HLI function)]]: | <li>[[IFSTRTN (IFAM2) (HLI function)]]: | ||
Latest revision as of 13:54, 12 December 2017
XDM subsystem
Summary
- Default value
- Current setting of the z/OS subsystem name linked into the IGCLM244 (CRAM) module
- Parameter type
- System
- Where set
- Cannot be reset
- Related products
- All
- Introduced
- Model 204 V6.1
Description
The XDMSSN parameter is available only for z/OS with CRAM-XDM.
The XDMSSN parameter passes a z/OS secondary subsystem name that overrides the value stored in the CRAM IGCLM244 module. That value, a maximum of four characters, is initially specified during CRAM installation.
Example: XDMSSN=SS03
On the client side, the XDMSSN parameter applies to the following IODEV threads and can be in the form:
subsystem:channel
where subsystem is a 4-character name, separated by a colon (:) from channel, which is an 8-character name.
| IODEV thread | Example or discussion |
|---|---|
| 11 | TSO: CALL ’DSN(M204FS)’ ’M204:M204FULL’ CICS: M204 M204:M204FULL DATA logon userid |
| 13 | Passed as part of the SQLConnect CLI function call via server name |
| 23 | Passed as part of the IFSTRTN (see example below) |
| 29 | Passed as part of the IFDIALN call with the CHAN parameter and BATCH2 (see example below) |
The subsystem name stored in IGCLM244 can also be overridden by BATCH2 or IFAM2 jobs as shown in the following examples:
- Program Communication facilities:
//BATCH2 EXEC PGM=BATCH2,PARM='[ssn:channel][,[OMC={Xhh|ddd}] [,URCTYPE={N|O|B}]]'
- IFSTRTN (IFAM2) (HLI function):
IFSTRTN|IFSTRN (RETCODE,LANG_IND,LOGIN,THRD_TYP,THRD_ID,[SSN:]CHAN)
- IFDIALN (HLI function):
IFDIALN|IFDILN (RETCODE,LANG_IND,[SSN:]CHAN,BUFFER,IO_LEN)