|
tsqctl performs inquiry and update operation on flat-file base temporary storage (TS) queues. It may list, control the status, delete, read and write all the local temporary storage queue hold by the region
Syntax
tsqctl [options] [queue_name]
Options
-Q,--queue
|
uses a 16 bytes queue identifie (QNAME)
|
-r,--read
|
reads the items in the queue
|
-w,--write
|
reads STDIN and writes an item in the queue
|
-d,--delete
|
deletes the queue
|
-q,--query
|
check the status of the queue
|
-l,--list
|
list the available queues
|
-L,--lines
|
with --write, reads from STDIN and writes each line read as a separate item
|
-i,--item <i>
|
with --read starts reading from item <i>
with --write rewrites item <i>
|
-u,--update-position
|
updates the queue current position indicator
|
-a,--region <name>
|
handles the TS queues of the region <name>, if active. Otherwise gets the first region active for the current user.
|
-p,--path <path>
|
handles the TS queues in <path>, even if a region is not active
|
-?,--help
|
shows the help text
|
Example
Listing the temporary storages of the active regions
# tsqctl --list
connected to shared memory of region CICSLX02
using repository: /home/fabrizio/tmp
queue cur.item num.item size file
---------------- -------- -------- -------- ------------------------------------
C_S0O0L2 1 1 65048 435f53304f304c320000000000000000.tsq
C_S0O0L3 1 1 65048 435f53304f304c330000000000000000.tsq
TSQUTEST 0 5 195144 54535155544553540000000000000000.tsq
TN010001 100 100 3284924 544e3031303030310000000000000000.tsq
TN010002 100 100 3284924 544e3031303030320000000000000000.tsq
TN010003 100 100 3284924 544e3031303030330000000000000000.tsq
TN010004 100 100 3284924 544e3031303030340000000000000000.tsq
TN010005 100 100 3284924 544e3031303030350000000000000000.tsq
TN010006 100 100 3284924 544e3031303030360000000000000000.tsq
TN010007 100 100 3284924 544e3031303030370000000000000000.tsq
TN010008 100 100 3284924 544e3031303030380000000000000000.tsq
TN010009 100 100 3284924 544e3031303030390000000000000000.tsq
TN010010 100 100 3284924 544e3031303031300000000000000000.tsq
Reading the content of a queue:
# tsqctl --read --item=1 TN010004
connected to shared memory of region CICSLX02
using repository: /home/fabrizio/tmp
queue TN010004:
item leng. content (first 80 bytes)
----- ----- ------------------------------------------------------------------------------
1 80 TN010004.0001
2 80 TN010004.0002
3 80 TN010004.0003
4 80 TN010004.0004
5 80 TN010004.0005
6 80 TN010004.0006
7 80 TN010004.0007
...
Writing an item at bottom of the queue:
# tsqctl --write TN010008
connected to shared memory of region CICSLX02
using repository: /home/fabrizio/tmp
adding item(s) at bottom
TEST ENTRY
<CTRL-D>
1 item(s) added (numitems=101)
Rewriting an item in the queue:
# tsqctl --write --item=2 TN010008
connected to shared memory of region CICSLX02
using repository: /home/fabrizio/tmp
rewriting item 2
NEW VALUE
1 item(s) rewritten (numitems=101)
Deleting a queue:
tsqctl --delete TN010008
connected to shared memory of region CICSLX02
using repository: /home/fabrizio/tmp
queue deleted
|
