IBM OS manual TS commands, Load Hold/Release, Retrieve Wait/Start

Models: OS

1 103
Download 103 pages 52.71 Kb
Page 82
Image 82
TS commands

 

TS commands

 

v The affinity here is between all transactions that use the same TS queue. It

 

applies to both MAIN and AUXILIARY TS. The match is made on the name of

 

the TS queue.

v The affinity relation can be GLOBAL, BAPPL, LUNAME, or USERID.

v Lifetime can be PCONV, LOGON, SIGNON, ACTIVITY, PROCESS,SYSTEM, and

 

PERMANENT. A MAIN queue cannot be recovered, regardless of de®nition, so

 

cannot cause PERMANENT.

 

v No data is collected if a TS queue is de®ned as remote or if a remote SYSID is

 

speci®ed on the TS command. In such cases, the request is satis®ed by a

 

remote CICS region or by a temporary storage pool in the coupling facility.

 

v Commands in error are treated in the same way as commands that give a

 

NORMAL response, so data is collected.

 

v If a TS queue is created and deleted within the same task, no data is collected.

 

Scanner differences: Scanner detects all instances of TS commands.

LOAD HOLD/RELEASE

 

v The affinity here is between all transactions that LOAD HOLD and RELEASE the

 

same program (or, more probably, table). The match is made on the program

 

name.

 

v The LOAD and RELEASE protocol applies only to programs that are de®ned with

 

RELOAD(NO). If the Detector can not establish the RELOAD attribute for some

 

reason, RELOAD(NO) is assumed.

 

v Once a LOAD HOLD has occurred for a program, any subsequent LOAD (with or

 

without HOLD) or RELEASE is part of the affinity.

v The affinity relation is GLOBAL or BAPPL.

 

v Lifetime is always SYSTEM.

 

v Commands in error are treated in the same way as commands that give a

 

NORMAL response, so data is collected.

 

v LOAD with no HOLD for programs de®ned as RESIDENT is not treated as an

 

affinity because relying on residency for sharing is inherently unsafe, the program

 

can be replaced by SET PROG() NEWCOPY.

 

v The incorrect use of RELEASE for a program de®ned with RELOAD(YES) is not

 

detected.

 

Scanner differences: Scanner detects all instances of LOAD, not just LOAD HOLD,

 

and all instances of RELEASE.

RETRIEVE WAIT/START

vThe affinity here is between all the transactions that issue START commands for a particular transaction at a terminal, where that transaction issues RETRIEVE WAIT. The transaction that issues the RETRIEVE WAIT is also part of the affinity. The match is made on the transid.

vThe affinity relation can be GLOBAL or USERID.

vLifetime can be SYSTEM or PERMANENT. PERMANENT is assumed if PROTECT is speci®ed on any START.

66 CICS Transaction Affinities Utility Guide

Page 82
Image 82
IBM OS manual TS commands, Load Hold/Release, Retrieve Wait/Start, CICS Transaction Affinities Utility Guide