specifies that the system is shut down immediately,
terminating all active tasks and ISC sessions. If
IMMEDIATE is not specified, all tasks are allowed to
finish, and ISC sessions are allowed to terminate normally.
ΓòÉΓòÉΓòÉ 9.22. CEMT SET AUXTRACE ΓòÉΓòÉΓòÉ
CEMT SET AUXTRACE
Function
Change auxiliary tracing options.
Description
For more information about traces, see the CICS for OS/2 Installation
book. See also the description of the CETR transaction in Setting up
trace-CETR transaction.
Syntax
Press the Clear key to clear the screen. There are two ways of
commencing this transaction:
Type CEMT SET AUXTRACE (the minimum abbreviation is CEMT S A).
You get a display that lists the current status, similar to that
obtained by CEMT INQUIRE AUXTRACE. You can then tab to the
highlighted or blank fields and overtype them with the required
values.
Type CEMT SET AUXTRACE (CEMT S A) followed by one or more
attribute settings that you wish to change. For example, cemt s
aux sto will stop auxiliary tracing.
>>ΓöÇΓöÇCEMT Set AuxtraceΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇ><
Γö£ΓöÇSTArtΓöÇΓöñ
Γö£ΓöÇPauseΓöÇΓöñ
ΓööΓöÇSTOpΓöÇΓöÇΓöÿ
Options
STArt|Pause|STOp
specifies the status of auxiliary tracing in your CICS
system. The values are:
STArt CICS is to start auxiliary tracing and open the
auxiliary trace file if it is currently closed.
Pause Auxiliary tracing is to stop, but the file is to
remain open. A subsequent START request causes
trace entries to be written immediately following
those that were written before the PAUSE request.
STOp CICS is to stop auxiliary tracing and close the
auxiliary trace file. A subsequent START request
causes new trace entries to be written at the
start of the data set, thereby overwriting the
trace entries that were written before the STOP
request.
ΓòÉΓòÉΓòÉ 9.23. CEMT SET CONNECTION ΓòÉΓòÉΓòÉ
CEMT SET CONNECTION
Function
Change the status of connections linked to specific terminals.
Description
Syntax
Press the Clear key to clear the screen. There are two ways of
commencing this transaction:
Type CEMT SET CONNECTION (the minimum abbreviation is CEMT S C)
followed by one or more connection identifiers or ALL. You get
a display that lists the current status, similar to that
obtained by CEMT INQUIRE CONNECTION. You can then tab to the
highlighted or blank fields and overtype them with the required
values.
Type CEMT SET CONNECTION (CEMT S C) followed by one or more
connection identifiers or ALL, followed in turn by one or more
attribute settings that you wish to change. For example, cemt s
c al i will reset the values for all connections to make them
available for use (inservice).
>>ΓöÇΓöÇCEMT Set ConnectionΓöÇΓöÇΓö¼ΓöÇ(value)ΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
specifies whether the SET command is to apply to one or
more connections, or whether it is to apply to all
connections. The values are:
(value) One or more names (1-4 characters) defined an
intersystem communication (ISC) connection.
ALl Any changes you request are made to all resources
of the specified type that you are authorized to
access.
Inservice|OUtservice
specifies whether the system can receive and send data.
The values are:
Inservice The system is in service; that is, it is
available for use.
ACquired|Released
specifies whether CICS is to acquire or release a session
with the logical unit represented by the CONNECTION name.
The values are:
ACquired The session is to be acquired.
Released The connection is to be released.
PUrge|FOrcepurge
specifies how associated transactions are to be purged.
The values are:
PUrge Transactions running on the connected system are
abnormally terminated. Transactions are
terminated only if system and data integrity can
be maintained.
FOrcepurge All transactions running on sessions on the
connected system are immediately terminated
abnormally. This can lead to unpredictable
results and should be used only in exceptional
circumstances.
In some extreme cases (for example, if an error
occurs during backout processing), CICS might
terminate abnormally.
ΓòÉΓòÉΓòÉ 9.24. CEMT SET FILE ΓòÉΓòÉΓòÉ
CEMT SET FILE
Function
Change some of the attributes of one or more File Manager files.
Syntax
Press the Clear key to clear the screen. There are two ways of
commencing this transaction:
Type CEMT SET FILE (the minimum abbreviation is CEMT S F) with
either a value corresponding to a file name or ALL. You get a
display that lists the current status, similar to that obtained
by CEMT INQUIRE FILE. You can then tab to the highlighted or
blank fields and overtype them with the required values.
Type CEMT SET FILE (CEMT S F) with either the name of a file or
ALL, followed by one or more attribute settings that you wish to
change. For example, cemt s fi al op will set all files open.
>>ΓöÇΓöÇCEMT Set FileΓöÇΓöÇΓö¼ΓöÇ(value)ΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇ><
specifies attributes are to be changed for one or more
names defined in the FCT, or for all files. The values
are:
(value) A name (1-8 characters) defined in the file
control table (FCT).
ALl Any change you request is made to all files that
you are authorized to access.
OPen|CLosed
specifies the status of the file. The values are:
OPen The file is open. If the file is OPEN ENABLED,
it is available for data accesses by CICS
transactions. If it is OPEN DISABLED, it must
first be enabled before it is available.
If the file was unenabled by a previous SET FILE
CLOSED command, the SET FILE OPEN command
reenables the file implicitly.
CLosed The file is closed; the access method does not
allow accesses to the data until the file is
opened. The file can be opened either explicitly
by the user or, if the file has the ENABLED
attribute, implicitly by CICS on the next
reference to the file.
When the SET FILE CLOSED command is used, the
file is closed and also disabled. (The file is
disabled to prevent access requests from
implicitly opening the file again.) The close is
effected at the time of the command only if there
are no tasks currently accessing the file.
A file that has been disabled by a SET FILE
CLOSED command becomes enabled again by a
subsequent SET FILE OPEN command. To distinguish
a file that has been disabled by a SET FILE
CLOSED from one that has been disabled by a SET
FILE DISABLED command, the SET FILE CLOSED
command closes the file with the UNENABLED
attribute.
A file with the DISABLED attribute can be enabled
only by a SET FILE ENABLED command. A file with
the UNENABLED attribute can be enabled by a SET
FILE ENABLED or SET FILE OPEN command.
ENabled|DIsabled
specifies whether transactions can access the file. The
values are:
ENabled The file is available for use by transactions
and, if closed, it is opened on the first
request. If the command CEMT SET FILE(value)
CLOSED ENABLED is given while the file is in use,
the status of the file becomes
`closed-unenabled'. If the command CEMT SET
FILE(value) CLOSED is given while the file is in
use, the file is disabled to prevent new users
accessing the file.
DIsabled The file is not available for use by transactions
except for those that are currently using it. If
there are any such users, `BEING DISABLED' is
also displayed. The CEMT SET FILE DISABLED
command has no effect on existing users; it
simply prevents new users from accessing the
file.
The file can be reenabled by a SET FILE ENABLED
command. (See also UNENABLED.)
It is not possible to disable a remote file.
EMptyrec|NOEMptyrec
specifies whether the file is to be made empty when it is
next opened. The values are:
EMptyrec Indicates that when a file is being opened, its
data is erased.
NOEmptyrec Indicates that when a file is being opened, its
data is not erased.
ΓòÉΓòÉΓòÉ 9.25. CEMT SET NETNAME ΓòÉΓòÉΓòÉ
CEMT SET NETNAME
Function
Change the attributes of named terminals in a network.
Description
The SET NETNAME command changes some of the values of a named
terminal in a network.
If you are familiar with network names, you may prefer to use this
command as an alternative to CEMT SET TERMINAL.
Syntax
Press the Clear key to clear the screen. There are two ways of
commencing this transaction:
Type CEMT SET NETNAME (the minimum abbreviation is CEMT S N)
with (value), CLASS(value), or ALL. You get a display that
lists the current status, similar to that obtained by CEMT
INQUIRE NETNAME. You can then tab to the highlighted and blank
fields and overtype them with the required values.
Type CEMT SET NETNAME (CEMT S N) with (value), or ALL, followed
by one or more attribute settings that you wish to change. For
example, cemt s n(value) i specifies that a named terminal is
available for use (inservice).
>>ΓöÇΓöÇCEMT Set NetnameΓöÇΓöÇΓö¼ΓöÇ(value)ΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
specifies the identifier of the terminal for which the
status is to be changed. The values are:
(value) A netname identifier (1-8 characters) as
specified in an installed terminal definition.
If the netname is, for example, CICSS201, this
option is coded thus:
CEMT SET NETNAME(CICSS201)
ALL Any changes you request are made to all resources
of the specified type that you are authorized to
access.
PRiority(value)
specifies the priority of a terminal relative to other
terminals. The priority of a task is the sum of the
transaction priority, the terminal priority, and the
operator priority. Priority has no meaning for terminals
that are ISC sessions being used as alternative facilities.
The value must be in the range 0-255, where 255 is the
highest priority.
Inservice|Outservice
specifies whether the terminal is available for use. The
values are:
Inservice The terminal is available for use.
Outservice The terminal is not available for use. Setting
a terminal OUTSERVICE means that the terminal can
no longer be used by transactions. If PURGE or
FORCEPURGE is also specified, any transaction
using the terminal is terminated abnormally. If
PURGE or FORCEPURGE is not specified, the
transaction is allowed to terminate normally, but
no further transactions are allowed to use the
terminal.
ATi|NOAti
specifies whether the terminal is available for use by
transactions that are initiated automatically from within
CICS. The values are:
ATi The terminal is available for use.
NOAti The terminal is not available for use.
PUrge|Forcepurge|CAncel
purges the transactions running with this terminal. The
values are:
PUrge Any transaction running with this terminal is
purged only if system and data integrity can be
maintained.
Forcepurge Any transaction running with this terminal is
immediately terminated abnormally. Data
integrity is not guaranteed. In some extreme
cases (for example, if an error occurs during
backout processing), CICS might terminate
abnormally.
CAncel AIDs queuing for the specified terminal are
canceled. AIDs representing scheduled and
allocated requests waiting in the local CICS
system for the specified terminal are canceled.
However, TD AIDs with an associated triggered
task already started are not canceled.
ACquired|RELeased
specifies whether CICS is in session with the logical unit
represented by this terminal. The values are:
ACquired CICS is in session with the logical unit
represented by the terminal.
RELeased CICS is not in session with the logical unit
represented by the terminal. Setting a terminal
RELEASED causes the session to be terminated.
Running transactions are allowed to finish unless
PURGE or FORCEPURGE is also specified.
ΓòÉΓòÉΓòÉ 9.26. CEMT SET PROGRAM ΓòÉΓòÉΓòÉ
CEMT SET PROGRAM
Function
Change the attributes of installed programs.
Description
Syntax
Press the Clear key to clear the screen. There are two ways of
commencing this transaction:
Type CEMT SET PROGRAM (the minimum abbreviation is CEMT S P).
You get a display that lists the current status, similar to that
obtained by CEMT INQUIRE PROGRAM. You can then tab to the
highlighted or blank fields and overtype them with the required
values.
Type CEMT SET PROGRAM (CEMT S P) followed by one or more
attribute settings that you wish to change. For example, cemt s
p(pgrmid) e ne will reset the values for the named program to
make it available for use (enabled) and a new copy of the
program will be used when all the transactions currently using
the program have finished (newcopy).
>>ΓöÇΓöÇCEMT Set PRogramΓöÇΓöÇΓö¼ΓöÇ(value)ΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇ><
specifies the name of the remote system to which CICS will
direct unrecognized transaction codes.
ΓòÉΓòÉΓòÉ 9.28. CEMT SET TASK ΓòÉΓòÉΓòÉ
CEMT SET TASK
Function
Change the status of tasks.
Description
You cannot use the symbols * and + to specify a family of tasks.
Syntax
Press the Clear key to clear the screen. There are two ways of
commencing this transaction:
Type CEMT SET TASK (the minimum abbreviation is CEMT S TA) with
(value) or ALL. You get a display that lists the current
status, similar to that obtained by CEMT INQUIRE TASK. You can
then tab to the highlighted or blank fields and overtype them
with the required values.
Type CEMT SET TASK (CEMT S TA) with number or ALL, followed by
one or more attribute settings that you wish to change. For
example, cemt s ta(value) pu will make the specified task
purgeable in system-stall conditions.
>>ΓöÇΓöÇCEMT Set TAskΓöÇΓöÇΓö¼ΓöÇ(value)ΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇ><
specifies that any changes you request are made to all
transaction classes.
Maxactive(value)
specifies the largest number of transactions in the
transaction class which are allowed to run concurrently.
The value can be in the range 0-99. Values greater than 99
are truncated.
ΓòÉΓòÉΓòÉ 9.30. CEMT SET TDQUEUE ΓòÉΓòÉΓòÉ
CEMT SET TDQUEUE
Function
Change the attributes of transient data queues.
Description
The SET TDQUEUE command changes some of the attributes of a transient
data queue that is defined in the destination control table (DCT).
The queue must not be REMOTE or INDIRECT.
Syntax
Press the Clear key to clear the screen. There are two ways of
commencing this transaction:
Type CEMT SET TDQUEUE (the minimum abbreviation is CEMT S TD)
with destid or ALL. You get a display that lists the current
status, similar to that obtained by CEMT INQUIRE TDQUEUE. You
can then tab to the highlighted or blank fields and overtype
them with the required values.
Type CEMT SET TDQUEUE (CEMT S TD) with (value) or ALL, followed
by one or more attribute settings that you wish to change. For
example, cemt s td(value) en op will make a named extrapartition
queue accessible by applications and open.
>>ΓöÇΓöÇCEMT Set TDqueueΓöÇΓöÇΓö¼ΓöÇ(value)ΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
specifies the identifier (1-4 characters) of a transient
data queue.
All
specifies that any changes you request are made to all
resources of the specified type that you are authorized to
access.
TRIggerlevel(value)
specifies the number (0-32767) of requests for output to a
queue that there must be before automatic transaction
initiation (ATI) occurs.
ENabled|Disabled
specifies whether the queue can be accessed by
applications. The values are:
ENabled The queue can be accessed by applications.
Disabled The queue cannot be accessed by applications,
although it can still be open. Queues with names
beginning with "C" cannot be disabled because
they are usually reserved for use by CICS.
Open|Closed
specifies whether the extrapartition queue is open or
closed. The values are:
Open The queue is open.
Closed The queue is closed.
ΓòÉΓòÉΓòÉ 9.31. CEMT SET TERMINAL ΓòÉΓòÉΓòÉ
CEMT SET TERMINAL
Function
Change the attributes of named terminals.
Description
The SET TERMINAL command changes some of the values of a named
terminal defined in the terminal control table (TCT), or which has
been autoinstalled.
If you are familiar with network names, you may prefer to use the
CEMT SET NETNAME command.
Syntax
Press the Clear key to clear the screen. There are two ways of
commencing this transaction:
Type CEMT SET TERMINAL (the minimum abbreviation is CEMT S TE)
with (value) or ALL. You get a display that lists the current
status, similar to that obtained by CEMT INQUIRE TERMINAL. You
can then tab to the highlighted or blank fields and overtype
them with the required values.
Type CEMT SET TERMINAL (CEMT S TE) with (value) or ALL, followed
by one or more attribute settings that you wish to change. For
example, cemt s te(value) i specifies that a named terminal is
available for use (inservice).
>>ΓöÇΓöÇCEMT Set TErminalΓöÇΓöÇΓö¼ΓöÇ(value)ΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
specifies the identifier(s) of the terminal(s) for which
the status is to be changed. The values are:
(value) A terminal identifier (1-4 characters) as
specified in an installed terminal definition.
If the terminal name is, for example, S201, this
option is coded thus:
CEMT SET TERMINAL(S201)
ALL Any changes you request are made to all resources
of the specified type that you are authorized to
access.
PRiority(value)
specifies the priority of a terminal relative to other
terminals. The priority of a task is the sum of the
transaction priority, the terminal priority, and the
operator priority. Priority has no meaning for terminals
that are ISC sessions being used as alternative facilities.
The value must be in the range 0-255, where 255 is the
highest priority.
Inservice|Outservice
specifies whether the terminal is available for use. The
values are:
Inservice The terminal is available for use.
Outservice The terminal is not available for use. Setting
a terminal OUTSERVICE means that the terminal can
no longer be used by transactions. If PURGE or
FORCEPURGE is also specified, any transaction
using the terminal is terminated abnormally. If
PURGE or FORCEPURGE is not specified, the
transaction is allowed to terminate normally, but
no further transactions are allowed to use the
terminal.
ATi|NOAti
specifies whether the terminal is available for use by
transactions that are initiated automatically from within
CICS. The values are:
ATi The terminal is available for use.
NOAti The terminal is not available for use.
PUrge|Forcepurge|CAncel
purges the transactions running with this terminal. The
values are:
PUrge Any transaction running with this terminal is
purged only if system and data integrity can be
maintained.
Forcepurge Any transaction running with this terminal is
immediately terminated abnormally. Data
integrity is not guaranteed. In some extreme
cases (for example, if an error occurs during
backout processing), CICS might terminate
abnormally.
CAncel AIDs queuing for the specified terminal are
canceled. AIDs representing scheduled and
allocated requests waiting in the local CICS
system for the specified terminal are canceled.
However, TD AIDs with an associated triggered
task already started are not canceled.
ACquired|RELeased
specifies whether CICS is in session with the logical unit
represented by this terminal. The values are:
ACquired CICS is in session with the logical unit
represented by the terminal.
RELeased CICS is not in session with the logical unit
represented by the terminal. Setting a terminal
RELEASED causes the session to be terminated.
Running transactions are allowed to finish unless
PURGE or FORCEPURGE is also specified.
ΓòÉΓòÉΓòÉ 9.32. CEMT SET TRANSACTION ΓòÉΓòÉΓòÉ
CEMT SET TRANSACTION
Function
Change some of the attributes of a selected transaction.
Syntax
Press the Clear key to clear the screen. There are two ways of
commencing this transaction:
Type CEMT SET TRANSACTION (the minimum abbreviation is CEMT S
TR) with (value), or ALL. You get a display that lists the
current status, similar to that obtained by CEMT INQUIRE
TRANSACTION. You can then tab to the highlighted or blank
fields and overtype them with the required values.
Type CEMT SET TRANSACTION (CEMT S TR) followed by one or more
attribute settings that you wish to change. For example, cemt s
trans(value) e pu specifies that a named transaction is
available for use (enabled) and is system-purgeable.
>>ΓöÇΓöÇCEMT Set TRansactionΓöÇΓöÇΓö¼ΓöÇ(value)ΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
(.txt)