Update the current value.

UPDATE COUNTER
>>-UPDATE--COUNTER(name)--+------------+--VALUE(data-value)----->
'-POOL(name)-'
>--+------------------------+--+------------------------+------><
'-COMPAREMIN(data-value)-' '-COMPAREMAX(data-value)-'
Conditions: INVREQ, SUPPRESSED

UPDATE DCOUNTER
>>-UPDATE--DCOUNTER(name)--+------------+--VALUE(data-area)----->
'-POOL(name)-'
>--+-----------------------+--+-----------------------+--------><
'-COMPAREMIN(data-area)-' '-COMPAREMAX(data-area)-'
Conditions: INVREQ, SUPPRESSED
Description
These counter commands set a new current
value for the named counter. COUNTER operates on fullword signed counters
and DCOUNTER on doublewordunsigned counters.
You can use the COMPAREMAX
and COMPAREMIN options to set a new current value only if it falls within
a specified range, or is above or below a specified value.
For information
about specifying fullword and doubleword variables on these named counter
commands, see CICS command argument values.
Options
- COMPAREMAX(data-value)
- specifies, as a fullword signed binary
value (doubleword unsigned binary value for DCOUNTER), a value to be compared
with the named counter's current value, and makes the result of the UPDATE
command conditional on the comparison:
- If the current value to be assigned is less than, or equal to, the value
specified on the COMPAREMAX parameter, the current value is reset, with response
normal
- If the current value is greater than the specified value, CICS returns an
exception condition.
The value you specify on the COMPAREMAX parameter can be less than
the value on the COMPAREMIN parameter, in which case the current value is
considered to be in range if it satsifies the COMPAREMIN or the COMPAREMAX
comparison. In the normal case where the COMPAREMIN value is less than the
COMPAREMAX value, the current value must satisfy both comparisons (that is,
it must lie between the two values).
- COMPAREMIN(data-value)
- specifies, as a fullword signed binary
value (doubleword unsigned binary value for DCOUNTER), a value to be compared
with the named counter's current value, and makes the result of the UPDATE
command conditional on the comparison:
- If the current value to be assigned is equal to, or greater than, the
value specified on the COMPAREMIN parameter, the CICS resets the current value,
with response normal
- If the current value is less than the specified value, CICS returns an
exception condition.
Note: The value you specify on the COMPAREMIN parameter can be greater
than the value on the COMPAREMAX parameter. See the COMPAREMAX parameter for
the effect of this.
- COUNTER(name)
- specifies
the name of the named counter for which the current number is to be reset
to the value specified on the value parameter. The name can be up to 16 alphanumeric
characters. If name is a variable that contains
a name that is less than 16 characters, the name must be padded with trailing
blanks.
- DCOUNTER(name)
- specifies
the name of the named counter for which the current number is to be reset
to the value specified on the value parameter. The name can be up to 16 alphanumeric
characters. If name is a variable that contains
a name that is less than 16 characters, the name must be padded with trailing
blanks.
- POOL(poolname)
- specifies the name of the pool in
which the named counter resides.
Valid characters for the pool selector
string are A through Z, 0 through 9, $ @ # and _ (underscore). If name is
a variable that contains a name that is less than 8 characters, the name must
be padded with trailing blanks.
This parameter is optional. If you
omit the name of the pool, a pool selector value of 8 blanks is assumed.
If
there is no matching entry in the DFHNCOPT options table, CICS uses the name
specified on the NCPLDFT system initialization parameter, which specifies
the default named counter pool.
For information about generating a
named counter options table using the DFHNCO macro, see the CICS Application Programming Guide.
- VALUE(data-value)
- specifies the new number to be set
as the current value for the named counter, using a fullword signed binary
value for COUNTER and a doubleword unsigned value for DCOUNTER.
Conditions
- INVREQ
- RESP2
values:
- 201
- Named counter not found.
- 301
- The server has reported an error code that is not understood by the named
counter interface. Generally, this is not possible unless the interface load
module, DFHNCIF, is at a lower maintenance or release level than the server
itself.
- 303
- An unexpected error, such as structure failure or loss of connectivity,
has occurred on a macro used to access the coupling facility. Further information
can be found in message DFHNC0441 in the CICS job log.
- 304
- The pool selection parameter specified in the program cannot be resolved
to a valid server name using the current options table.
- 305
- The interface is unable to establish a connection to the server for the
selected named counter pool. Further information can be found in an AXM services
message (AXMSCnnnn) in the CICS job log.
- 306
- An abend occurred during server processing of a request. Further information
can be found in a message in the CICS job log and the server job log.
- 308
- The DFHNCOPT options table module, required for resolving a pool name,
could not be loaded.
- 309
- During processing of the options table, the named counter interface encountered
an unknown entry format. Either the options table is not correctly generated,
or the DFHNCIF interface load module is not at the same release level as the
options table.
- 310
- An options table entry matching the given pool name specified a user exit
program, but the user exit program is not link-edited with the options table
and cannot be loaded.
- 311
- A response from the named counter server to the client region interface
module, DFHNCIF, indicates that a system-managed rebuild is in progress but
the EXEC CICS interface does not recognize the condition. This means that
the CICS region is at CICS TS 2.1 or earlier.
- 403
- The POOL parameter contains invalid characters or embedded spaces.
- 404
- The COUNTER parameter contains invalid characters or embedded spaces.
- 406
- The VALUE parameter is invalid. You cannot set the current value to less
than the minimum value, or greater than the maximum value plus 1.
Default action: terminate the task abnormally.
- SUPPRESSED
- RESP2
values:
- 103
- The current value of the named counter is:
- not within the range specified by the COMPAREMAX and COMPAREMIN parameters,
when both are specified
- greater than the COMPAREMAX parameter or less than the COMPAREMIN parameter,
when only one option is specified.
Default action: terminate the task abnormally.