Define a TERMINAL in the local CICS region.
CREATE TERMINAL >>-CREATE TERMINAL(data-value)----------------------------------> >--+-ATTRIBUTES(data-value)--ATTRLEN(data-value)-+------------->< +-COMPLETE------------------------------------+ '-DISCARD-------------------------------------' CREATE TERMINAL attribute values: .-ALTPRINTCOPY(NO)--. |--+-------------------+--+-------------------+-----------------> '-ALTPRINTCOPY(YES)-' '-ALTPRINTER(char4)-' .-ATTACHSEC(LOCAL)------. .-AUTINSTMODEL(NO)---. >--+-----------------------+--+--------------------+------------> +-ATTACHSEC(IDENTIFY)---+ +-AUTINSTMODEL(ONLY)-+ +-ATTACHSEC(MIXIDPE)----+ '-AUTINSTMODEL(YES)--' +-ATTACHSEC(PERSISTENT)-+ '-ATTACHSEC(VERIFY)-----' >--+--------------------+--+---------------------+--------------> '-AUTINSTNAME(char8)-' '-BINDPASSWORD(hex16)-' .-BINDSECURITY(NO)--. .-CONSOLE(NO)-----. >--+-------------------+--+-----------------+-------------------> '-BINDSECURITY(YES)-' '-CONSNAME(char8)-' .-INSERVICE(YES)-. >--+---------------------+--+----------------+------------------> '-DESCRIPTION(char58)-' '-INSERVICE(NO)--' >--+-----------------+--+------------+--+----------------+------> '-MODENAME(char8)-' +-NATLANG(E)-+ '-NETNAME(char8)-' '-NATLANG(K)-' .-PRINTERCOPY(NO)--. >--+-------------+--+----------------+--+------------------+----> '-POOL(char8)-' '-PRINTER(char4)-' '-PRINTERCOPY(YES)-' >--+---------------------+--------------------------------------> '-REMOTESYSNET(char8)-' >--+-------------------------------------------+----------------> '-REMOTESYSTEM(char4)-+-------------------+-' '-REMOTENAME(char4)-' .-SOLICITED(NO)--. >--+---------------------+--+----------------+------------------> '-SECURITYNAME(char8)-' '-SOLICITED(YES)-' .-TASKLIMIT(NO)------. .-TERMPRIORITY(0)-----. >--+--------------------+--+---------------------+--------------> '-TASKLIMIT(1-32767)-' '-TERMPRIORITY(0-255)-' >--+--------------------+--TYPETERM(char8)--+---------------+---| '-TRANSACTION(char4)-' '-USERID(char8)-'
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
The CREATE TERMINAL command installs a TERMINAL definition with the attribute specified on the command. It does not use a resource definition stored in the CSD. You can use them either to define individual terminals or a pool of terminals.
The POOL attribute determines which mode you are using. Without it, each command defines a single, independent terminal. If there is already a terminal with the name you specify in the local CICS region, the new definition replaces the old one; if not, the new definition is added.
To define a pool, you issue one CREATE TERMINAL ATTRIBUTES command for each terminal in the pool, specifying the same POOL value in the ATTRIBUTES string. After all of the terminals are defined, you issue CREATE TERMINAL COMPLETE; CICS collects but does not install the TERMINAL definitions until the COMPLETE command. At this point, if there was a pool of the same name in the local CICS region, CICS deletes all of its terminals and installs the new definitions; if not, it adds the new definitions. Consequently, pool terminals must be defined all at once; you cannot add terminals to an existing pool or include a terminal with the same name as an existing non-pool terminal.
During the time the pool is being built, you may not:
However, if you encounter an error or problem during the course of building a pool, you can terminate the process at any point by issuing a CREATE TERMINAL DISCARD command. If you do this, CICS discards the partial pool definition, including all of its terminals.
A syncpoint is implicit in CREATE TERMINAL processing, as in other CREATE commands, except when an exception condition is detected early in the processing. Uncommitted changes to recoverable resources are committed when definitions are processed successfully, and rolled back if not or if you specify DISCARD. For non-pool terminals, the syncpoint occurs on each CREATE command. When you are building a pool, however, it occurs only on the command that ends the pool definition, whether you specify COMPLETE or DISCARD. See Creating resource definitions for other general rules governing CREATE commands.