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 we 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 we 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