Use the CNOSC general macro with the RESET verb specified to reset the LU
6.2 session limit for parallel or single session connections to
0.
Format
- label
- A symbolic name can be assigned to the macro statement.
- RESET
- Directs the CNOSC macro to perform the RESET verb function.
- LUNAME
- Specifies the symbolic name of a field or a register pointing to a
field. This is a 16-byte field that contains the network name of the
partner (remote) LU to which the session limit and contention-winner polarity
reset applies. The first 8 bytes contain the left-justified network
name, which is padded with blanks, or all blanks if the LU name is
unqualified. The second 8 bytes contain the left-justified LU name,
which is padded with blanks.
- MODE
- Specifies the symbolic name of a field or a register pointing to a
field. This is an 8-byte field that contains the mode name for which
the session limit and polarities are to be reset.
You can specify a user-defined mode name or one of the following
values:
- ALL
- Specifies that the session limit for all mode names that apply to the
target LU are reset to 0, except the SNA-defined mode SNASVCMG, which remains
unchanged. This is the default value.
- singmode
- Specifies the mode name for single sessions as defined by the SINGMODE
parameter of the SNAKEY macro. See TPF ACF/SNA
Network Generation for more information about the SNAKEY macro.
- SNASVCMG
- Specifies the SNA-defined mode name used to exchange CNOS verbs between
the source and target LUs connected by parallel sessions.
- RESP
- Specifies which LU is responsible for deactivating the session as a result
of resetting the session limit for parallel sessions. This parameter is
not applicable to single session connections or the SNASVCMG session.
The allowed values are:
- SOURCE
- Specifies that the source LU is responsible for deactivating sessions as a
result of resetting the session limit. The target LU cannot negotiate
this argument. This is the default value.
- TARGET
- Specifies that the target LU is responsible for deactivating sessions as a
result of resetting the session limit. The target LU can negotiate this
argument to make the source LU responsible.
- DRAIN
- Specifies which LU (or both) can drain its allocation requests. If
you do not code this parameter, no draining is allowed for either LU, and all
outstanding and subsequent allocation requests will be rejected. This
parameter is not valid for SNASVCMG connections. The allowed values
are:
- SOURCE
- Specifies that the source LU can drain its allocation requests. The
target LU cannot negotiate this argument. The source LU continues to
allocate conversations to the sessions until no requests are waiting for
allocation, at which time its draining ends. Allocation requests
subsequent to the completion of draining are rejected.
- TARGET
- Specifies that the target LU can drain its allocation requests. The
target LU can reject this argument; in this case no draining takes
place.
The target LU continues to allocate conversations to the sessions until no
requests are waiting for allocation, at which time its draining ends.
Allocation requests subsequent to the completion of draining are
rejected. This value is not valid for single session
connections.
- BOTH
- Specifies that both the source and target LUs can drain their allocation
requests. This value is not valid for single session
connections.
- FORCE
- Specifies whether the source LU should force the resetting of its session
limit upon the unsuccessful completion of the CNOS request or reply
exchange. This parameter does not apply to SNASVCMG or single session
connections. The allowed values are:
- Y
- Specifies that a reset should be forced. In this case, RESP
defaults to SOURCE and no draining by either source or target LU takes
place.
- N
- Specifies that a reset should not be forced. The session limit is
reset only upon successful completion of the CNOS request or reply
exchange. This value is the default.
- RCODE
- Specifies the symbolic name of a field or a register that points to a
field. This is a 6-byte field in which the return code is
placed. The return code consists of a 2-byte primary return code
followed by a 4-byte secondary return code. The actual values returned
are listed in Return Conditions.
Entry Requirements
See Entry Requirements for the entry requirements relating to the CNOSC macro in
general.
Return Conditions
- The results of the verb are indicated by the value returned in
RCODE. The valid return codes are listed in the following
section.
- See Return Conditions for the return conditions relating to the CNOSC macro in
general.
- The following table contains a list of the primary and secondary return
codes that can be returned to the program that issued the RESET verb. A
complete list of return codes and their definitions can be found in Table 3 and in Table 4.
Symbolic Name
| Primary Code
| Secondary Code
|
CNOSRC_OK
| 0000
|
|
CNOSRC_AS_SPECIFIED
| ....
| 00000000
|
CNOSRC_AS_NEGOTIATED
| ....
| 00000004
|
CNOSRC_FORCED
| ....
| 00000008
|
CNOSRC_PARAMETER_ERROR
| 0004
|
|
CNOSRC_INVALID_LU
| ....
| 00000014
|
CNOSRC_INVALID_MODE
| ....
| 00000018
|
CNOSRC_ZERO_LIMITS_REQ
| ....
| 00000028
|
CNOSRC_ALLOC_ERROR
| 0008
|
|
CNOSRC_RETRY_LATER
| ....
| 0000000C
|
CNOSRC_NO_RETRY
| ....
| 00000010
|
CNOSRC_RACE_REJECT
| 000C
|
|
CNOSRC_RESOURCE_FAILURE
| 0014
|
|
CNOSRC_NO_RETRY
| ....
| 00000010
|
CNOSRC_LOCAL_NOT_ACTIVE
| ....
| 00000064
|
CNOSRC_INVALID_REQ
| 0020
|
|
CNOSRC_ALREADY_RESET
| ....
| 0000002C
|
CNOSRC_INVALID_STATE
| ....
| 00000030
|
Programming Considerations
- If you specify a register for a keyword value, the register must be
enclosed in parentheses and in the range R1-R7.
- The RESET verb starts a conversation with the LU name specified to
exchange information in the specified mode name. The macro generates an
ALLOCATE, a SEND to send the limit and polarity information to the remote LU,
a RECEIVE to receive the reply. The remote LU then issues a
DEALLOCATE. When you issue the RESET verb, the program gives up control
while waiting for the reply from the remote LU.
- Note:
- This does not apply to single session mode names or the SNASVCMG mode
name.
- See Programming Considerations for programming considerations relating to the CNOSC macro
in general.
Examples
SYMB100 CNOSC RESET, X
LUNAME=(R1), X
MODE=ALL, X
RESP=SOURCE, X
DRAIN=BOTH, X
FORCE=Y, X
RCODE=(R4)