z/OS: System Admin. Guide

  1. z/OS: System Admin. Guide

  2. Figures

  3. Tables

  4. About this book

  5. Who this book is for

  6. What you need to know to understand this book

  7. Conventions used in this book

  8. Syntax diagrams

  9. How to read railroad diagrams

  10. How to read dotted decimal diagrams

  11. Summary of changes

  12. Changes for this edition (SC34-6585-00)

  13. Operating WebSphere MQ for z/OS

  14. Operating WebSphere MQ for z/OS

  15. Issuing commands

  16. Issuing commands from a z/OS console or its equivalent

  17. Issuing commands from the utility program CSQUTIL

  18. Introducing the operations and control panels

  19. Invoking the operations and control panels

  20. Rules for the operations and control panels

  21. Objects and actions

  22. Object dispositions

  23. Choosing a queue manager

  24. Using the function keys

  25. Using the command line

  26. Using the operations and control panels

  27. Defining objects

  28. Defining a local queue

  29. When your local queue definition is complete

  30. Defining other types of objects

  31. Working with object definitions

  32. Altering an object definition

  33. Displaying an object definition

  34. Delete an object

  35. Working with namelists

  36. Starting and stopping a queue manager

  37. Before you start WebSphere MQ

  38. Starting a queue manager

  39. Start options

  40. Starting after an abnormal termination

  41. User messages on start-up

  42. Stopping a queue manager

  43. Stop messages

  44. Writing programs to administer WebSphere MQ

  45. Understanding how it all works

  46. Before you begin

  47. Preparing queues for administration programs

  48. Defining the system-command input queue

  49. Defining a reply-to queue

  50. Opening the system-command input queue

  51. Opening a reply-to queue

  52. Using the command server

  53. Identifying the queue manager that processes your commands

  54. Starting the command server

  55. Sending commands to the command server

  56. Putting messages on the system-command input queue

  57. Retrieving replies to your commands

  58. Waiting for a reply

  59. The reply message descriptor

  60. Interpreting the replies

  61. Using the DISPLAY commands

  62. Examples of commands and their replies

  63. Messages from a DEFINE command

  64. Messages from a DELETE command

  65. Messages from DISPLAY commands

  66. Messages from commands with CMDSCOPE

  67. Messages from commands that generate commands with CMDSCOPE

  68. If you do not receive a reply

  69. Passing commands using MGCRE

  70. WebSphere MQ and CICS

  71. Operating the CICS adapter

  72. Invoking the adapter's control functions

  73. From the CICS adapter control panels

  74. From the CICS command line

  75. From CICS application programs

  76. Accessing the CICS adapter control panels

  77. Starting a connection

  78. Starting a connection from the CICS adapter control panels

  79. Starting a connection from the CICS command line

  80. Starting a connection from a CICS application program

  81. Stopping a connection

  82. Stopping a connection from the CICS adapter control panels

  83. Stopping a connection from the CICS command line

  84. Stopping a connection from a CICS application program

  85. Modifying a connection

  86. Modifying a connection from the CICS adapter control panels

  87. Modifying a connection from the CICS command line

  88. Modifying a connection from a CICS application program

  89. Displaying details of connections and CICS tasks

  90. Displaying details of a connection from the CICS adapter control panels

  91. Starting an instance of the task initiator CKTI

  92. Starting CKTI from the CICS adapter control panels

  93. Starting CKTI from the CICS command line

  94. Starting CKTI from a CICS application program

  95. Starting CKTI automatically

  96. Stopping an instance of CKTI

  97. Stopping an instance of CKTI from the CICS adapter control panels

  98. Stopping an instance of CKTI from the command line

  99. Stopping an instance of CKTI from an application program

  100. Displaying the current instances of CKTI

  101. Displaying the current instances of CKTI from the CICS adapter control panels

  102. Displaying CICS task information

  103. Displaying CICS tasks from the CICS adapter control panels

  104. Displaying connection status and in-flight tasks

  105. Purging tasks that are using the CICS adapter

  106. Shutting down a connection between WebSphere MQ and the CICS adapter

  107. Orderly shutdown

  108. Forced shutdown

  109. Operating the CICS bridge

  110. Starting the CICS bridge

  111. Shutting down the CICS bridge

  112. WebSphere MQ and IMS

  113. Operating the IMS adapter

  114. Controlling IMS connections

  115. Connecting from the IMS control region

  116. Initializing the adapter and connecting to the queue manager

  117. Thread attachment

  118. Displaying in-doubt units of recovery

  119. Recovering in-doubt units of recovery

  120. Resolving residual recovery entries

  121. Controlling IMS dependent region connections

  122. Connecting from dependent regions

  123. Region error options

  124. Monitoring the activity on connections

  125. Disconnecting from dependent regions

  126. Disconnecting from IMS

  127. Controlling the IMS trigger monitor

  128. Starting CSQQTRMN

  129. Stopping CSQQTRMN

  130. Controlling the IMS bridge

  131. Starting and stopping the IMS bridge

  132. Controlling IMS connections

  133. Controlling bridge queues

  134. Resynchronizing the IMS bridge

  135. Considerations for Commit mode 1 transactions

  136. Delete messages from IMS

  137. Delete Tpipes

  138. Managing WebSphere MQ resources

  139. Managing the logs

  140. Archiving logs with the ARCHIVE LOG command

  141. Restarting the log archive process after a failure

  142. Controlling archiving and logging

  143. Printing log records

  144. Recovering logs

  145. Discarding archive log data sets

  146. Automatic archive log data set deletion

  147. Manually deleting archive log data sets

  148. The impact of log shunting

  149. Managing the BSDS

  150. Finding out what the BSDS contains

  151. Time stamps in the BSDS

  152. Active log data set status

  153. Changing the BSDS

  154. Changes for active logs

  155. Changes for archive logs

  156. Recovering the BSDS

  157. Managing page sets

  158. How to add a page set to a queue manager

  159. What to do when one of your page sets becomes full

  160. How to balance loads on page sets

  161. Moving a non-shared queue

  162. How to expand a page set

  163. Defining a page set to be larger than 4GB

  164. Altering a page set to allow automatic expansion

  165. Moving messages to a new, larger page set

  166. How to reduce a page set

  167. How to reintroduce a page set

  168. How to back up and recover page sets

  169. Creating a point of recovery for non-shared resources

  170. Recovering page sets

  171. How to delete page sets

  172. How to back up and restore queues using CSQUTIL

  173. Managing buffer pools

  174. How to change the number of buffers in a buffer pool

  175. How to delete a buffer pool

  176. Managing queue-sharing groups and shared queues

  177. Managing queue-sharing groups

  178. Adding a queue-sharing group to the DB2 tables

  179. Adding a queue manager to a queue-sharing group

  180. Removing a queue manager from a queue-sharing group

  181. Removing a queue-sharing group from the DB2 tables

  182. Validating the consistency of DB2 definitions

  183. Managing shared queues

  184. Recovering shared queues

  185. Moving shared queues

  186. Migrating non-shared queues to shared queues

  187. Suspending a connection to DB2

  188. Managing group objects

  189. Managing the Coupling Facility

  190. Adding a Coupling Facility structure

  191. Removing a Coupling Facility structure

  192. Recovery and restart

  193. Restarting WebSphere MQ

  194. Restarting after a normal shutdown

  195. Restarting after an abnormal termination

  196. Restarting if you have lost your page sets

  197. Restarting if you have lost your log data sets

  198. Restarting if you have lost your CF structures

  199. Recovering a single queue manager at an alternative site

  200. Fast copy techniques

  201. Recovering a queue-sharing group

  202. CF structure media recovery

  203. Backing up the queue-sharing group at the prime site

  204. Recovering a queue-sharing group at the alternative site

  205. Reinitializing a queue manager

  206. Reinitializing a queue manager that is not in a queue-sharing group

  207. Reinitializing queue managers in a queue-sharing group

  208. Using the z/OS Automatic Restart Manager (ARM)

  209. What is the ARM?

  210. ARM couple data sets

  211. ARM policies

  212. Defining an ARM policy

  213. Activating an ARM policy

  214. Using ARM in a WebSphere MQ network

  215. Restarting on a different z/OS image with LU 6.2

  216. Restarting on a different z/OS image with TCP/IP

  217. Recovering units of work manually

  218. Displaying connections and threads

  219. Active units of work

  220. Unresolved units of work

  221. Recovering CICS units of recovery manually

  222. What happens when the CICS adapter restarts

  223. How to resolve CICS units of recovery manually

  224. Recovering IMS units of recovery manually

  225. What happens when the IMS adapter restarts

  226. How to resolve IMS units of recovery manually

  227. Recovering RRS units of recovery manually

  228. Recovering units of recovery on another queue manager in the queue-sharing group

  229. Example recovery scenarios

  230. Shared queue problems

  231. Queue is both private and shared

  232. Active log problems

  233. Dual logging is lost

  234. Active log stopped

  235. One or both copies of the active log data set are damaged

  236. Write I/O errors on an active log data set

  237. I/O errors occur while reading the active log

  238. Active log is becoming full

  239. Active log is full

  240. Archive log problems

  241. Allocation problems

  242. Off-load task terminated abnormally

  243. Insufficient DASD space to complete off-load processing

  244. Read I/O errors on the archive data set while WebSphere MQ is restarting

  245. BSDS problems

  246. Error occurs while opening the BSDS

  247. Log content does not agree with the BSDS information

  248. Both copies of the BSDS are damaged

  249. Unequal time stamps

  250. Out of synchronization

  251. I/O error

  252. Page set problems

  253. Page set I/O errors

  254. Page set full

  255. Coupling Facility and DB2 problems

  256. Storage medium full

  257. A DB2 system fails

  258. A DB2 data-sharing group fails

  259. DB2 and the Coupling Facility fail

  260. Problems with long-running units of work

  261. Old unit of work found during restart

  262. IMS-related problems

  263. IMS cannot connect to WebSphere MQ

  264. IMS application problem

  265. IMS is not operational

  266. Hardware problems

  267. Using the WebSphere MQ utilities

  268. WebSphere MQ utility program (CSQUTIL)

  269. Invoking the WebSphere MQ utility program

  270. PARM parameters

  271. Which PARM parameters do you need?

  272. Return codes

  273. Monitoring the progress of the WebSphere MQ utility program

  274. Formatting page sets (FORMAT)

  275. Keywords and parameters

  276. Example

  277. Usage notes

  278. Page set information (PAGEINFO)

  279. Keywords and parameters

  280. Example

  281. Usage notes

  282. Expanding a page set (COPYPAGE)

  283. Keywords and parameters

  284. Example

  285. Usage notes

  286. Copying a page set and resetting the log (RESETPAGE)

  287. Using the RESETPAGE function

  288. Keywords and parameters

  289. Example

  290. Usage notes

  291. Issuing commands to WebSphere MQ (COMMAND)

  292. Keywords and parameters

  293. Examples

  294. Issuing commands

  295. Making a list of DEFINE commands

  296. Making a list of ALTER commands

  297. Making a client channel definition file

  298. Usage notes

  299. Producing a list of WebSphere MQ define commands (SDEFS)

  300. Keywords and parameters

  301. Examples

  302. Usage notes

  303. Copying queues into a data set while the queue manager is running (COPY)

  304. Keywords and parameters

  305. Example

  306. Usage notes

  307. Syncpoints

  308. Copying queues into a data set while the queue manager is not running (SCOPY)

  309. Keywords and parameters

  310. Example

  311. Usage notes

  312. Emptying a queue of all messages (EMPTY)

  313. Keywords and parameters

  314. Example

  315. Usage notes

  316. Restoring messages from a data set to a queue (LOAD)

  317. Keywords and parameters

  318. Example

  319. Usage notes

  320. Migrating a channel initiator parameter module (XPARM)

  321. Keywords and parameters

  322. Example

  323. The change log inventory utility (CSQJU003)

  324. Invoking the CSQJU003 utility

  325. Data definition (DD) statements

  326. Multiple statement operation

  327. Adding information about a data set to the BSDS (NEWLOG)

  328. Keywords and parameters

  329. Delete information about a data set from the BSDS (DELETE)

  330. Keywords and parameters

  331. Supplying a password for archive log data sets (ARCHIVE)

  332. Keywords and parameters

  333. Controlling the next restart (CRESTART)

  334. Keywords and parameters

  335. Set checkpoint records (CHECKPT)

  336. Keywords and parameters

  337. Updating the highest written log RBA (HIGHRBA)

  338. Keywords and parameters

  339. The print log map utility (CSQJU004)

  340. Invoking the CSQJU004 utility

  341. Data definition statements

  342. The log print utility (CSQ1LOGP)

  343. Invoking the CSQ1LOGP utility

  344. Input control parameters

  345. Usage notes

  346. The EXTRACT function

  347. Processing EXTRACT data

  348. Example 1. Counting the number of bytes put to each queue

  349. Output

  350. Detail report

  351. Record layouts for the output data sets

  352. The queue-sharing group utility (CSQ5PQSG)

  353. Invoking the queue-sharing group utility

  354. Data definition statements

  355. Keywords and parameters

  356. Example

  357. The active log preformat utility (CSQJUFMT)

  358. Invoking the CSQJUFMT utility

  359. The dead-letter queue handler utility (CSQUDLQH)

  360. Invoking the DLQ handler

  361. Data definition statements

  362. Sample JCL

  363. The DLQ handler rules table

  364. Control data

  365. Rules (patterns and actions)

  366. The pattern-matching keywords

  367. The action keywords

  368. Rules table conventions

  369. Processing the rules table

  370. Ensuring that all DLQ messages are processed

  371. An example DLQ handler rules table

  372. Appendixes

  373. Appendix A. User messages on start-up

  374. Appendix B. Notices

  375. Programming interface information

  376. Trademarks

  377. Index