Index. IBM z/OS Version 2 Release 3

ALET qualified address 5 purpose 5 when ALET qualification is required 5

example 313

ALET

ALET (access list entry token)

definition 286

example of loading a zero into an

AR 291 loading into an AR 291

use 286

ALET (address list entry token)

for primary address space 289 with a value of zero 289

ALET-qualified address

used in macro parameter list 293

algorithm

run length encoding 419 used by data compression service 419 used by data expansion service 419

alias

addressing mode 61 establishing 61

AMODE 64

issuing macros 235

linkage conventions

register 15 contents 234

AMODE program attribute

changing 33, 34 indicator 33, 34

purpose 33

specifying 33, 34 value 34

anchor 245

answer area system logger

size 479

APF-authorization

when needed by problem state program 47

application resource

releasing through recovery 147

AR (access register)

example of loading an ALET of zero into 291

rules for coding 289

use 286, 300

using 285

AR information

formatting and displaying 294

AR instruction

for manipulating contents of

ARs 290

AR mode

coding instructions 289

description 285

example 288

importance of comma 290

importance of the contents of

AR mode program

call a primary mode program 24

call an AR mode program 23

defined 5

linkage procedure 22

pass parameters 25

receive control from a caller 22

return control to a caller 22, 23

ARCHECK subcommand

formatting and displaying AR information 294

architecture level 205

ARR (associated recovery routine)

choosing 151

using 173

ASC mode

AR mode program defined 5

definition 285

primary mode program, defined 5

switching 285

557

ASC mode (continued)

switching mode 6 when control is received 6

assembler example

window service 351

assembler instruction

examples of use in AR mode 291 use in AR mode 288, 289, 291

assistive technologies 547

ATTACH and ATTACHX macros

addressing mode consideration 47

ECB parameter 188

ESTAI parameter 151, 163

ATTACH macro

creating subpools 222

DPMOD parameter 28

ECB parameter, use 30

ETXR parameter, use 30

example of sharing DU-ALs 313

GSPL parameter 221

GSPV parameter 221

LPMOD parameter 28

requesting subpool ownership 221

sharing a DU-AL with subtask 313

SHSPL parameter 221

SHSPV parameter 221 specify subpools 221

SZERO parameter 221

TASKLIB parameter 48, 49

use 27, 39, 47

authorization requirements

IXGCONN service 488

system logger 470

system logger application program 471

system logger couple data set 470 system logger, IXCMIAPU utility 470

availability

increasing through recovery 147

B

BAL instruction 34

BALR instruction 34

BAS (branch and save) instruction 34

BAS instruction 34

base register

establishing 19

BASR (branch and save instruction register form) 34

BASR instruction 34

BASSM (branch and save and set mode) 35

BASSM instruction 35, 56

BLDL macro 51, 56

BLDMPB macro 414

blocks of an object

identifying blocks to be viewed 345

size 333

558

z/OS MVS Assembler Services Guide blocks of an object (continued)

updating blocks in a temporary object 347

updating blocks on DASD 348

BLOCKS parameter on DSPSERV 303,

309, 321, 325

branch instruction

BAL (branch and link) 34

BALR (branch and link register) 34

use with XCTL, danger 59

branching table

use in analyzing return codes 44

bring a load module into virtual storage 47

BSM (branch and set mode) 34

BSM instruction 34

build a symptom record 207

C

CALL macro

use 42, 43, 54, 56

callable cell pool service

advantages of using 245 compared to the CPOOL macro 245

data space 310

data space example 311

calling program

definition 5

calling sequence identifier 62

cell 218, 246

allocating 250 deallocating 250

cell pool 246

activating 249

anchor 245

contracting 249 creating 249 deactivating 249 disconnecting 249 expanding 249

extent 245

obtaining 218

obtaining status about 250

cell pool service

cell pool service (continued)

CSRPRGT1 service 250 query 250

central storage

sharing through IARVSERV macro 375

changing

example 35, 36

using BSM or BASSM 34

CHAP macro

use 29

characters printed on an MCS console 388

check groups function of unit verification service 531 check units function of unit verification service 531

checkpoint 358

checkpoint/restart

manage storage 317, 331

CHKPT macro 358

CHNGDUMP command 196

choose the name of a data space 303

CnzConv macro

retrieving console information 394

code

descriptor 390

message routing 389

code instructions in AR mode 289

comma

careful use of in AR mode 290

communication

in a recovery environment 162

in a sysplex environment 393

provided by recovery 147

compiler

message 406

invoking 407

compress data

steps required 420

using the data compression service 419

compression of data

description 424

symbols 421

concatenated data sets 48

concurrent request for resource

limiting 127

connect

allocating coupling facility space 487

to a log stream 486

console

CnzConv macro 394

CONVCON macro 394

determining status 397

determining the name or ID 395

parameter list

initializing field 395

retrieving information 394

validating a name or ID 397

constrained transactions 526

contact

z/OS 547

control

in a dynamic structure 57

in a simple structure 44

return 44, 46, 57

control virtual storage 219

CONVCON macro

parameter list 395

retrieving console information 394

convention

for passing control 39

convert device type to look-up value function of unit verification service 532

converting central to virtual address 383

CONVTOD macro

structure storage limit reached 493

coupling facility

system logger

damage 517

failure 517, 519 full condition 519

loss of connectivity to 518

system logger data on 465

coupling facility structure system logger

storage limit reached 493

coupling facility version number

CPOOL macro

CPUTIMER macro

CPYA instruction

create

create data space

example 292, 305, 316

rules for 302

create hiperspace

example 320

CSRCESRV macro 420

CSRCMPSC macro 420, 424

CSREVW window service

defining a view of an object 342

CSRIDAC window service

obtaining access to a data object 341

terminating access to an object 350

CSRL16J service

passing control with all registers intact 36

CSRREFR window service

updating a permanent object on

CSRSAVE window service

DASD 348

CSRSCOT window service

saving interim changes in a scroll area 346

updating a temporary object 347

CSRVIEW window service

defining a view of an object 342

terminating a view of an object 348

CSVINFO macro

Comparison with CSVQUERY 62

MIPR 62

CSVQUERY macro

Comparison with CSVINFO 62

current size of data space 304

D

DAE (dump analysis and elimination)

dump not suppressed 201

dump suppression 196

providing information through recovery 158

DASD (direct access storage device)

data transfer from by window services 335

updating a permanent object on

DASD 348

DASD log data set

space 520

DASD-only

log stream 481

DASD-only log stream

system logger data on 466

data compression and expansion service

data which can exploit 419 recovery routine 419

data compression and expansion services

using 419

data compression service

steps required to compress data 420

using 419

data control block

deleting load modules that contain 225

SNAP dump 202

data expansion service 420

using 419

data object

access to a data object, procedure for 341

defining a view 342

defining multiple views 345 extending the size 345

identifying 341

mapping 333, 335, 336, 337 multiple objects, example 337

data object (continued)

multiple windows to an object, example 336

obtaining

access to a data object,

overview 340, 341, 342

saving interim changes 346

scroll area 342

scroll area to DASD, example 335

specifying type of access 342

structure 333

temporary object, example 336

terminating access to an object 350

updating a temporary object 347

window to a scroll area, example 335 window to DASD, example 335

data set

dump 202

data sharing with IARVSERV macro 375

data space

access data 301

choosing the name for 303

compared to address space 295

establish addressability 306

example 292, 296

example of creating 316 example of deleting 316

example of moving data into and out 306

example of using 316

extending current size 308

identifying the origin 305

illustration 295

loading pages into central storage 309

managing storage 297

paging out of central storage 309

shared between two programs 312,

313

sharing with IARVSERV macro 375

specify size 303

storage available for 297

use 296, 300

using efficiently 316

data space storage

managing 297

release 301

releasing 309 rules for releasing 309

data to be viewed 345

Index

559

data-in-virtual

mapping a hiperspace object to an address space window 330

mapping into hiperspace 328, 329

data-in-virtual object

definition 257, 333

mapped into data space storage 314,

315

data-in-virtual window

requirements for 257

date and time of day

obtaining 385

DCB parameter 50

DD statements required for dumps 196

DE parameter 51

debugging aid for call sequence 61

define multiple views of an object 345

define the expected window reference pattern 344

define view of a data object 342

define window disposition 343

delete

access list entry 292 example 292

delete data space

delete data spaces

DELETE macro

lowering the responsibility count 225

delete message 388

delete messages already written 394

deleting

from a log stream 500

DETACH macro

device

device class

DFP requirement for window service 341

dictionary

compression 421

entries 425

expansion 421

directory entry

PDS (partitioned data set) 33

disconnecting

from a log stream 486

dispatching priority 28 assign 28

display AR information 294

DIV (data-in-virtual) service restrictions

when using IARVSERV macro 382

DIV macro

example 331

DIV macro (continued)

example of mapping object into data space 315

mapping a data-in-virtual object to a hiperspace

example 329

mapping a hiperspace as a data-in-virtual object

example 331

mapping object to a data space 314

programming example 276

retain mode 269, 273, 275

rules for invoking 276 sharing data in a window among tasks 276

use 259, 328

save 270

unaccess 275 unidentify 275

unmap 274

using data-in virtual 257

when to use data-in-virtual 258

DOM macro

function 394

DPMOD parameter on ATTACH 28

DSPSERV macro

CREATE request

example 292, 305, 321, 326, 329,

331

DELETE request

example 292, 326, 330, 331

EXTEND request

LOAD service

OUT service

RELEASE request

DU-AL

compared with a PASN-AL 287 definition 287 illustration 287

dump

ABEND dump 195

data sets for 202 index in SNAP dump 202

not suppressed 201

requesting 195

requesting in recovery 158

select type 195

SNAP dump 195, 202 summary 202

suppression 196 symptom 196

SYSABEND dump 195

SYSMDUMP dump 195

SYSUDUMP dump 195

Transaction dump 195, 203

types a problem program can request 195 dump service 195

dump storage in a data space 317

560

z/OS MVS Assembler Services Guide duplicate

names in unique task libraries, 50

resource request 128

dynamic I/O configuration change

detecting 437

dynamic load module structure

advantage 39 description 38, 39

E

EAR instruction

description 290

ECB (event control block)

description 116 parameter of ATTACH 30, 31, 116

EDT (eligible device table)

description 439

obtaining information 440

unit verification service

IEFEB4UV routine 531

EDTINFO macro 440

end-of-task exit routine 30

ENF event code 48

system logger application 480

ENQ macro 133

example 128

use 57

entry point

adding 61 address 42, 61 alias use 61 identifier 61

identify 42

EP parameter 49

EPIE (extended program interruption element) 142

EPLOC parameter 49

error

recovering from software 145

ESD (external symbol dictionary)

AMODE/RMODE indicator 33

ESO hiperspace

definition 320

ESPIE environment

deleting 139 establishing 139

ESPIE macro

option 139, 141

use 139

using 141

ESPIE percolation 143

establish addressability to a data space 306

definition 286

example 316

ESTAE and ESTAEX macros

CT parameter 151, 189

checking for TOD-clock synchronization 385

ESTAE and ESTAEX routine

definition 151

ESTAE-type recovery routine (extended specify task abnormal exit)

providing 150

ESTAI routine

definition 151

ETR (External Time Reference hardware facility)

ETXR parameter of ATTACH

use 30

event

signal completion 116

EVENTS macro

use 116

exabyte

description 227

example

data object mapped to a window 334

mapping

permanent object that has no scroll

area 335, 336, 337 multiple objects 337

object to multiple windows 336

permanent object that has a scroll area 335

structure of a data object 334

system logger services

64–bit virtual addressing support 472

temporary object 336

window services coding example 351

exclusive resource control 126

EXCP macro 101

EXCPVR macro 102

exit routine

altering register content 143 altering the old PSW 143

end-of-task 30

functions performed by 143

register contents on entry 142

specifying 139

expand data

steps required 420

expanded data

using the data expansion service 419

expansion of data

description 425

explicit requests for virtual storage 214

extend current size of data space

example 308 procedure 308

extend current size of hiperspace

procedure for 325

EXTEND parameter on DSPSERV 308,

325

extend the size of an object 345

extent 245

F

find

load module 48

form

execute 223 list 223

form (continued)

standard 223

format AR information 294

frame

assigning 359 repossessing 359

FREEMAIN macro

use 214, 218

functions

check groups 531, 535 check units 531, 535

convert device type to look-up

value 532, 541

indicate unit name is a look-up

value 532, 539

return attributes 532, 541

return group ID 532, 538

return look-up value 532, 540

return unit control block (UCB)

address 532, 537

return unit name 532, 536

return unit names for a device

class 532, 543

specify subpool for returned

storage 532, 542

G

gap in reference pattern service

defining 366 definition 366

gap in reference pattern services

definition 366

GENNAME parameter on

DSPSERV 302, 303, 320

GETMAIN macro

creating subpools 222

LOC parameter 214, 215 requesting storage at an address 215

type 214 use 214

gigabyte 33

global resource 125

global resource serialization 133

GQSCAN macro

function 133

GRS effects scope 137

result 136

TOKEN parameter 134

GRS

affects scope on GQSCAN macro 137

guard area

changing its size 241

H

hiperspace

as data-in-virtual object 330

compared to address space 295

extending current size 325

fast data transfer 323

illustration 295

hiperspace (continued)

managing storage 297

manipulating data

illustration 318

mapping data-in-virtual object

into 328, 329

referencing data 321

releasing storage 325

restoring 331 saving 331

shared between two programs 323

specify size 303

storage available for 297

two types 319

window services use 335

hiperspace storage

managing 297

releasing 325 rules for releasing 325

HSPALET parameter on HSPSERV macro 323

HSPSERV macro 323 example 323

read operation 321, 322

SREAD and SWRITE operation

example 326

illustration 321 write operation 321

HSTYPE parameter on DSPSERV 320

I

I/O configuration change

detecting 437

I/O configuration token

detecting I/O configuration changes with 437

IARR2V macro

ASID parameter 383 converting a central storage address to virtual 383

IARVSERV sharing effectiveness 383

NUMVALID parameter 383

NUMVIEW parameter 383

RSA parameter 383

STOKEN parameter 383

VSA parameter 383

WORKREG parameter 383

IARV64 macro

using 236

IARVSERV macro

CHANGEACCESS parameter 378

copy-on-write 380

CVT mapping macro hardware check 381

data sharing 375

diagnostics 383

example of use 381

IARVRL mapping macro

required fields 380 parameters description 380

RANGLIST parameter 380

READONLY parameter 380

restrictions using DIV (data-in-virtual) service 382 restrictions using DIV (data-in-virtual) services 382

Index

561

IARVSERV macro (continued)

RETAIN parameter 381

SHARE parameter 378

SHAREDWRITE parameter 380

sharing effectiveness 383

SHRDATA IPCS subcommand 383

TARGET_VIEW parameter 380

types of views 377

UNIQUEWRITE parameter 380

identify a data object 341

identify a window 343

identify blocks to be viewed 345

identify the origin of the data space 305

IEAARR macros

tracking entries in the linkage stack 185

IEALSQRY macro

IEANTCR callable service 353

IEANTDL callable service 353

IEANTRT callable service 353

IEFEB4UV routine 531

authorized caller 533 caller's function 533 key 533 mode 533 problem program caller 533

implicit requests for virtual storage 223

import connection

IXGCONN service

IMPORTCONNECT parameter 488

import log blocks

IXGIMPRT service 501, 502

INADDR parameter on the GETMAIN macro 215

INADDR parameter on the STORAGE macro 217

indicator

in a PDS entry 33

in an entry point address 35, 47

initial size of data space 304

initiate offload

IXGOFFLD service 507

inline parameter list

use 42

installation limit

amount of storage for data space and hiperspace 303

on amount of storage for data space and hiperspace 297 on size of data space and hiperspace 297

size of data space 303

interlock

avoiding 131 illustration 131

internal reader facility

allocating the data set 443, 444

closing the data set 446 coding /*DEL 446 coding /*EOF 446 coding /*PURGE 446

definition 443

example 446

opening the data set 444

sending records to the data set 445

562

z/OS MVS Assembler Services Guide internal reader facility (continued)

setting up and using 443 tasks involved in using 443

through dynamic allocation 444

through JCL 443

interval timing, establish 386

INTRDR data set 443

IOCINFO macro 437

IPCS (interactive program control system)

formatting and displaying AR information 294

ISGENQ macro

compared to the ENQ macro 132 using for shared resources 132 using with the DEQ macro 132

issue macros in AMODE 64 235

issue macros in AR mode 293

IXGANSAA macro

answer area mapping 478

IXGBRWSE service

browse cursor 496 browse session 496 browse token 496

MULTIBLOCK parameter 498

read data from a log stream 495

REQUEST=READBLOCK 496

REQUEST=READCURSOR 497

REQUEST=RESET 496

REQUEST=START 496

searching for a log block by time stamp 497

illustration 498

with IXGDELET service 500

with IXGWRITE service 499

IXGCONN service

allocating coupling facility space at connection 487

authorization requirements 488 connect process and staging data sets 488

connecting to and disconnection from a log stream 486

disconnect from a log stream 489

import connection 488

user data for a log stream

USERDATA parameter 489

write connection 488

IXGDELET service delete data from a log stream

illustration 501

deleting data from a log stream 500

IXGIMPRT service 501

import log blocks 501, 502

manage a target log stream 507

safe import point 504

IXGINVNT service

DASDONLY parameter 481

managing the LOGR policy 480

MODEL parameter 480

example 481

IXGOFFLD service

initiate offload 507 manage a target log stream 507

IXGQUERY service

coupling facility version number 506

log stream information 503

manage a target log stream 507

IXGQUERY service (continued)

safe import point 504

IXGUPDAT service

modify log stream control information 508 time stamp 508

IXGWRITE service

BUFFALET parameter 491 log block buffer 491

BUFFKEY parameter 491

BUFFLEN parameter 492 sequence of log blocks 492

write to a log stream 491

J

JES (job entry subsystem)

and the internal reader 443, 444, 445

job library

reason for limiting size 50

use 47

when to define 51

job output

sending to the internal reader 445

job step task

create 27

JPA (job pack area) 48

K

keyboard

navigation 547

PF keys 547 shortcut keys 547

L

LAE instruction

LAM instruction

language

checking availability 411

library

description 48 search 48

limit priority 28

linear data set

creating a 259

link library 47

LINK macro

addressing mode consideration 47

linkage

linkage conventions

advantages of using the linkage stack 7

AR mode program linkage procedure 22

AR mode program, defined 5

establish a base register 19

linkage conventions (continued)

for branch instruction 5

in AMODE 64 234 register 15 contents 234

introduction 5

parameter convention 24

primary mode program linkage procedure 19

primary mode program, defined 5

register save area, provide 6 register, saving 6

using a caller-provided save area 8

using the linkage stack 7

linkage stack

advantages of using 7

at time of retry 184

considerations for ESTAE-type recovery routines 170

example of using the 8

how to use 7

LINKX macro

use 54

load

registers and pass control 40

virtual storage 362

load an ALET into an AR 291

load instruction in AR mode

example 290

load list 48

LOAD macro

indicating addressing mode 47

load module

how to avoid getting an unusable copy 53

location 47

more than one version 49

using an existing copy 52

load module execution 39

loaded module

information 62

LOC parameter on the GETMAIN

macro 214, 215

LOC parameter on the STORAGE macro

requesting storage at an address 217

local resource 125

location of a load module 47

log block buffer 491

BUFFALET parameter 491

BUFFKEY parameter 491

BUFFLEN parameter 492

log data

on DASD log data sets 465, 466

connection to

log stream (continued)

definition 463

delete data from

illustration 501

deleting data from

IXGDELET service 500

different ways of connecting to 486

disconnection from

IXGCONN service 486

gaps in 475

illustration 463

JCL specification 511

read from

write to

writing to

sequence of log blocks 492

log stream information

IXGQUERY service 503

log stream time stamp

IXGUPDAT service 508

LOGR policy managing

IXGINVNT service 480

LOGR subsystem 509

read log data in data set format

eligible applications 509

using 510

Logrec Data Set

description 205

look-up value for the EDT

defined 532 obtaining 532

LPA (link pack area) 48

LPMOD parameter on ATTACH 28

LQB (language query block) 411

M

macro

form 223

issuing in AMODE 64 235

issuing in AR mode 293

reenterable form 223 way of passing parameters 223

mainline routine

definition in a recovery environment 150

manage a target log stream 507

managing the LOGR policy

IXGINVNT service 480

manipulate data in hiperspace 318

manipulate the contents of ARs 290

map data-in-virtual object into data space

rules for problem state program 315

map data-in-virtual object into hiperspace 329 example 329

rules for problem state program 328

map hiperspace as data-in-virtual object 330

example 331

map object into data space

using DIV macro 315

map object to a data space

using DIV macro 314

maximum size of data space 304

MCS console

characters displayed 388

member names

MEMLIMIT

memory object

creating 237 example of 237

deleting a 241

discard pages that back pages 240

example of creating with a guard area 242

example of creating, using and freeing a 243

example of deleting a 241

ownership 236

releasing physical resources that back pages of 240

message

deleting 388, 394

descriptor code 390 disposition 390

example of WTO 391

identifier 392

indicator in first character 390

MLWTO (multiple-line) 389

message file

message skeleton

message text

messages

z/OS MVS Programming: Assembler

Services Guide xvii

MIPR

CSVINFO macro 62

MLWTO (multiple-line) message

considerations for using 389

MMS (MVS message service) 399, 419

coding example 416

support for additional language 415

mode

primary 285

MODE parameter 474

MODE=ASNYCNORESPONSE parameter 475

modify log stream control information

IXGUPDAT service 508

module

obtaining a copy 53

pass control 57

Index

563

move data between hiperspace and address space 321

MPB (message parameter block) 414 building 414 using BLDMPB and

UPDTMPB 414 using for new message 414

multiple versions of load modules 49

MVS macro

issuing in AMODE 64 235

issuing in AR mode 293

N

name

resource 124

name a data space 303

NAME parameter on DSPSERV 302,

303, 320

name/token callable service

link-editing with your application 358

use of the service 353

name/token pair

creating 354

deciding which to use 355

definition 353

deleting 354

home 357 level 357

home address space 354 primary address space 354 system 354

task 354, 355

retrieving the token 354

navigation

keyboard 547

non-reenterable load module 225

non-shared standard hiperspace

creating 320 definition 320

nonconstrained transactions 525

NUMRANGE parameter on

HSPSERV 322

O

obtain access to a data object 341

operator

consoles, characters displayed 388 messages, writing 388

option

RESET parameter 141

SET parameter 141

TEST parameter 141

origin of data space 305

originating task 27

OUTNAME parameter on

DSPSERV 302, 303

overlay load module structure 38

P

page

faults, decreasing 364

movement 359

564

z/OS MVS Assembler Services Guide page (continued)

size 359

page out virtual storage 362 page-ahead function 362

paging service

parallel execution

parameter convention 24

parameter list

description 40 example of passing 40

indicate end 42 inline, use 42

location 59

parameter list for AR mode program

illustration 25

PASN-AL

add entry 301

compared with a DU-AL 287 definition 287

pass control

between control sections 40

between programs with all registers intact 36

between programs with different

AMODEs 35, 56

between programs with the same

AMODE 35

in a dynamic structure 47, 54, 58, 60

in a simple structure 39, 41, 46

preparation 39

prepare 41

using a branch instruction 42, 58

using CALL 43

using LINK 54

using the CSRL16J service 36

with a parameter list 41

with return 41, 54

without control program

assistance 39, 56, 57

without return 39, 58

pass parameter

list 223 register 223

pass return address 39

PDS directory entry

AMODE indicator 33

RMODE indicator 33

percolate

definition in a recovery environment 153

percolation

ESPIE 143

permanent object

access to a permanent object, procedure for 341 accessing an existing object 341 creating a new object 341

data transfer 335

data-in-virtual object, relationship 333

defining a view 342

defining multiple views 345

functions supported for 338

permanent object (continued)

extending the size 345

identifying 341

mapping a scroll area to a permanent object, example 335 mapping with no scroll area, example 335

new object, creating 341

obtaining

access to a permanent object,

overview 340, 341, 342

overview of supported function 338

requirements for new object 341

refreshing, overview 340

saving changes, overview 340

saving interim changes 346

scroll area 342

size, maximum 333

specifying new or old status 341

specifying type of access for an existing object 342

structure 333

terminating access to a permanent object 350

updating on DASD 348

PGLOAD macro

page-ahead function 362

PGOUT macro

PGRLSE macro

PGSER macro

page-ahead function 362

protecting a range of virtual storage pages 361

use 360

PICA (program interruption control area)

pointer 140 purpose 140 restore previous 140

PIE (program interruption element)

purpose 140

planned overlay load module structure 38

pointer-defined entry point address 35

post bit 116

POST macro

use 116

prepare to pass control

primary mode

primary mode program

receive control from a caller 19

return control to a caller 21

priority

address space 28 assign 28

priority (continued)

change 28 control program's influence 28 dispatch 28 higher, when to assign 28 limit 28 subtask 28 task 28

private library 47

processor storage management 359, 375

program availability

increasing through recovery 147

program design 39

program interruption

cause 139

determine cause 141

determining the type 143

program management 33

program mask 140

program object

definition 47

protecting

via serialization 123

PSL (page service list) 363

PSW (program status word)

addressing mode bit 34, 35

PUT macro 445

Q

qname of a resource

R

range list entry 380

RANGLIST parameter on HSPSERV 322,

327

RB (request block)

considerations for ESTAE-type recovery routines 170

relationship to ESTAE-type recovery routines 151

read

from a log stream 495

log data in data set format

LOGR subsystem 509

LOGR subsystem

eligible applications 509

read from a standard hiperspace 322,

326

read operation

for standard hiperspace 321, 322

recovery 145, 194

ABEND dump

requesting 158

ABEND macro

choosing to issue 149

invoking RTM 188

STEP parameter 172

activated

advantages of providing 147

advanced topics 188

recovery (continued)

AMODE

ARR

choosing 151

using 173

ASC mode

ATTACH and ATTACHX macros

ESTAE-type recovery routine 180

ECB parameter 188

ESTAI parameter 151, 163

authorization

means available to recovery routines 162 parameter area 150, 162 registers 162

availability

increasing 147

communication

between processes 147

SDWA 155, 162

SETRP macro 155

concepts 146

condition of the linkage stack

retry from an ESTAE-type recovery routine 183

correcting errors 159

DAE

providing information 158

deactivated

deciding whether to provide 147

defined

designing into your program 145

dispatchable unit mode

DU-AL

retry from an ESTAE-type recovery routine 183

dump

ABEND dump 158

checking for previous 159

requesting 158

environment

ESTAE-type recovery routine 180 factors other than register contents 180

register contents 174

recovery (continued) environment (continued)

STAE and STAI routines 191

summary for ESTAE-type recovery routine and its retry routine 183

understanding 173

errors 148 examples 148

ESTAE and ESTAEX macros

CT parameter 151, 189

activated 151 deactivated 151 defined 151 definition 151 no longer defined 151

ESTAE and ESTAEX routine

ESTAE-type recovery routine

additional considerations 172

linkage stack considerations 170

outstanding I/Os 171

providing 150

RB considerations 170

RB relationship 151

return codes 176

special considerations 170

ESTAI routine

activated 151 deactivated 151 defined 151 definition 151 no longer defined 151

rules for retry RB 170

example

coded 185

mainline routine with one recovery routine 154

mainline routine with several recovery routines 155

footprints 158, 163

from software errors 145

general concepts 146

IEALSQRY macro 185

in control

interrupt status

multiple recovery routines 189

mainline routine

definition 150

minimizing errors 159

MVS-provided 147

no longer defined

no longer in control

recovery (continued) outstanding I/O

not providing 148

Index

565

restoring quiesced restorable I/O operations 171

outstanding I/Os

controlling 171

parameter area

accessing 162, 163

checking the contents 158

contents 162

footprints 158, 163 passing 150, 162, 163

setting up 162

percolate

compared with retry 159

definition 153

program availability

increasing 147

program mask

retry from an ESTAE-type recovery routine 183

quiesced restorable I/O operation

restoring 171

recovery routine

choosing 150 definition 150

providing recovery for a recovery routine 189

retrying 160

states 149

summary of states 152

writing 155

recursion

avoiding 158 definition 158

register contents 174 entry to a recovery routine 174

entry to a retry routine 177

restoring 160

return from a recovery routine 176

STAE or STAI retry routines 193

STAE routine 191

summary of where to find information 174

retry

compared with percolate 159

retry point

retry routine

routines in a recovery environment

definition 149

interaction 153

mainline routine 150 recovery routine 150 retry routine 150

RTM 145 recovery (continued)

invoking 188

SDWA

accessing 165

accessing the SDWARC1

DSECT 166

checking important fields 157

directly manipulating fields 158

freeing 160

IHASDWA mapping macro 165

summary of important fields 166

updating 155, 165

updating through SETRP macro 158 updating through VRADATA macro 158

using 165

SDWA storage key

ESTAE-type recovery routine 180

saving 158 updating the SDWA 158

serviceability data

providing 148

SETRP macro

communicating recovery options to the system 165

COMPCOD parameter 165

DUMP parameter 158

FRESDWA parameter 160, 177

indicating percolation 161

indicating retry 160

RC parameter 160, 161

REASON parameter 165

RECPARM parameter 158

REMREC parameter 161

RETADDR parameter 160

RETREGS parameter 160, 177

supplying a retry address 160

updating the SDWA 155, 165

STAE macro

CT parameter 151 defining a recovery routine 151

STAE retry routine 192

STAE routine

return codes 192

work area 191

STAI retry routine 192

STAI routine

return codes 192

activated 149 deactivated 149 defined 149 in control 149 no longer defined 149 no longer in control 149

work area 191

state of recovery routine

system logger 515 application failure 515

coupling facility failure 517

coupling facility full 519

DASD log data set space fills 520

recovery (continued)

system logger (continued)

log stream damage 519

peer connector 516

staging data set full 519

system failure 516 system logger address space failure 516

unrecoverable I/O errors 521

task 151

validity checking of user parameters 148

VRADATA macro

updating the SDWA variable recording area 158

writing recovery routines 155

checking for the SDWA 156

checking important fields in the

SDWA 157

checking the parameter area 158

comparison of retry and percolate 159 correcting or minimizing errors 159 determining if the recovery routine can retry 159

determining the first recovery routine to get control 157 determining why the routine was entered 157 establishing addressability to the parameter area 157 locating the parameter area 157

providing information for

DAE 158 requesting a dump 158 saving serviceability data 158

saving the return address to the system 156

recursion

avoiding in recovery 158 definition in recovery 158

reenterable

load module 53, 57, 223 macro 223

reenterable code

use 214, 218, 223

reenterable load module

use 216, 223

reference pattern service 364, 375

reference unit in reference pattern service

choosing 366 definition 366

reference unit in reference pattern services

REFPAT macro

refresh changed data in an object 347

refreshable module 225

REGION system parameter 213

register

altering the content 143

provide a save area 6 save 6

566

z/OS MVS Assembler Services Guide

register 1

register 14

register 15

release

data space and hiperspace storage 297

data space storage 309 rules 309

hiperspace storage 325 rules for 325

resource 129

virtual storage 359

RELEASE parameter on HSPSERV macro 322

release storage in data spaces

rules 309

remove

entry from access list 292

REPLACE option for a window 343

reply to WTOR message 392

request

dump 195

request for resource

limit concurrent 127

requesting

conditionally 129

exclusive control 126

pair 132

shared control 126

unconditionally 129

requirements for window service

resource

collecting information 133

control 115

duplicate request 128

global 125 local 125 name list 125

naming 124

process request 127

protecting 115, 124, 125, 127, 128, 129 release 129

releasing through recovery 147

requesting 115, 124, 125, 127, 128,

129

scope 134

serially reusable 115, 124, 125, 127,

128, 129

types that can be shared 125

using 123, 132

resource protection

via serialization 123

resource queue

extracting information 133

resource serialization

avoiding an interlock 131

requesting exclusive control 126 requesting shared control 126

responsibility count for a loaded module 225

restore

data space 317

hiperspace 331

PICA (program interrupt control area) 140

registers upon return 44

RETAIN option for a window 343

retry

definition in recovery environment 152

retry point

definition 150

retry routine

definition 150

ensure correct level of the linkage stack 184

return address

pass 39

return attributes function of unit verification service 532

return code

analyzing 44

establish 45

for cell pool service 251

using 44

return group ID function of unit verification service 532 return look-up value function of unit verification service 532

RETURN macro

use 45

return UCB addresses function of unit verification service 532 return unit name function of unit verification service 532

returned storage

specify subpool 532

reusability attributes of a load module 57

reusable module 53

reuse of a save area 42

RIB (resource information block)

used with GQSCAN macro 134

RMODE program attribute

indicator in PDS entry 33 purpose 33

specifying 33, 47 use 47

value 33

route

code 389 message 389

route message 390 route the message 390

RTM (recovery termination manager)

MVS component that handles recovery 145

run length encoding 419

run-time message file

updating 410

S

SAC instruction

example of using a 8, 10, 12, 13, 18

SAC instruction (continued)

safe import point

SAR instruction

save

save area

how to tell if used 45

pass address 40

reuse 42

using a caller-provided save area 8

who must provide 6

save interim changes to a permanent object 346

SAVE macro

example of using 9

use 61

scope

ALL parameter value on GQSCAN macro 136

on GQSCAN macro

as affected by GRS 137

STEP parameter value on GQSCAN

macro 134, 136

SYSTEM parameter value on

GQSCAN macro 134, 136

SYSTEMS parameter value on

GQSCAN macro 134, 136

scope of a resource

changing 125

STEP, when to use 125

SYSPLEX, when to use 126

SYSTEMS, when to use 126

SCOPE parameter on DSPSERV 302

scroll area

data transfer 335

definition 334

mapping a scroll area to DASD, example 335 mapping a window to a scroll area, example 335

obtaining a scroll area 342

refreshing a scroll area 347

saving changes in, overview 340

saving interim changes in a 346

storage used for 334

updating a permanent object from a scroll area 348

updating DASD from, overview 340

use 334

SCROLL hiperspace 319

SDB (structured data base) format

description 207

SDWA (system diagnostic work area)

providing symptom data for a dump 199

SDWAARER field 167

SDWAARSV field 168

SDWACID field 158, 169

SDWACLUP bit 159, 169

SDWACMPC field 157, 167

Index

567

SDWA (system diagnostic work area)

(continued)

SDWACOMU field 169

SDWACRC field 157, 167

SDWAEAS bit 159, 169

SDWAEC1 field 167

SDWAEC2 field 167

SDWAG64 field 167, 169

SDWAGRSV field 167

SDWAINTF bit 167, 168

SDWALNTH field 168

SDWALSLV field 169, 185

SDWAMLVL field 158, 169

SDWAPARM field 157, 166

SDWAPERC bit 157, 169

SDWARPIV bit 167

SDWARRL field 158, 169

SDWASC field 158, 169

SDWATXPSW16 field 169

SDWAXFLG field 167, 168

search for a load module 48, 52

areas/libraries searched 49 limiting 49 order 49

sending comments to IBM xv

serially reusable

use 123

serviceability data

providing through recovery 148

saving in the SDWA 158

set up addressability to a data space

system logger configuration 509

SETRP macro

COMPCOD parameter 165

DUMP parameter 158

FRESDWA parameter 160, 177

RC parameter 160, 161

REASON parameter 165

RECPARM parameter 158

REMREC parameter 161

RETADDR parameter 160

RETREGS parameter 160, 177

updating the SDWA 155

share subpools 220, 222

shared pages 375

shared resource control

through the ENQ macro 126

through the RESERVE macro 132

shared standard hiperspace

definition 320

shared storage

with IARVSERV macro 375

sharing data in virtual storage

summary 3

sharing data in virtual storage

(IARVSERV macro) 375

sharing data spaces 313

568

z/OS MVS Assembler Services Guide

shortcut keys 547

simple load module structure 38

SMS requirement for window service 341

SNAP data control block 202

SNAP dump

index 202 requesting 202

SNAP macro

use 202

SNAPX macro

use 202

software error

recovering 145

specify subpool for returned storage 532

specifying

in source code 33 using linkage editor control card 33

SPIE (specify program interruption exit) environment

addressing mode 139

adjusting 140 canceling 140 definition 140 reestablishing 140

SPIE macro

addressing mode restriction 139

use 139, 140

STAE macro

CT parameter 151 defining a recovery routine 151

STAE routine

storage limit reached 494

staging data sets

formatting 494

full condition 519

STAI routine

read and write operation 322

STAM instruction

description 290

standard hiperspace

definition 319

example of creating 321

non-shared 320

shared 320

use 319

START parameter on DSPSERV 309, 325

STATUS macro 29

STCKCONV macro

reason for limiting size 50

STCKSYNC macro

using 385

step library

use 47

STIMER macro

STIMERM macro

STOKEN parameter on ALESERV 292

STOKEN parameter on DSPSERV 292,

302, 320

STOKEN parameter on HSPSERV 322

storage

freshly obtained 261

managing data space 310

subpool returned storage 532

storage available for data space and hiperspace 297

STORAGE macro

OBTAIN request

storage request

structure of a data object 333

subpool

characteristic 220

creating 222

handling 219

in task communication 222

ownership 221

sharing 220, 222

storage key for 221

transferring ownership 222

subpool release

definition 218

substitution token 402

subtask

communication with tasks 29

control 27 create 27

priority 28

starting 29 stopping 29

terminating 30, 116

summary dump 202

summary of changes xvii

Summary of changes xviii

suppression

of dumps 196

symbol substitution

summary 3

symptom

provided by a recovery routine 199

required for dump suppression 166

symptom dump 196

symptom record 207

description 205

SYMRBLD macro

building a symptom record 205, 207

SYMREC macro

symptom recording 205

SYSABEND ABEND dump 195

SYSMDUMP ABEND dump 195

sysplex environment

communication 393

SYSSTATE AMODE64= macro

example 235 use 235

SYSSTATE macro

example 293 use 53, 202, 293

system convention for parameter list 40

SYSTEM inclusion resource name list 125

system log

writing 393

system logger

ANSAREA parameter 478 answer area 478

size 479

answer area mapping

IXGANSAA macro 478

authorization requirements 470

component 468

configuration 466

illustration 467, 468

connecting to and disconnection from a log stream 486

DASD-only log stream 466

definition 463

delete data from a log stream

illustration 501

IXGDELET service 500

disconnect service 489

IXGBRWSE service

MULTIBLOCK parameter 498

REQUEST=READBLOCK 496

REQUEST=READCURSOR 497

REQUEST=RESET 496

REQUEST=START 496

searching for a log block by time stamp 497

with IXGDELET service 500

with IXGWRITE service 499

log data sets

allocation 466

log stream 463, 464

illustration 463

LOGR subsystem 509 eligible applications 509

using 510

managing the LOGR policy

IXGINVNT service 480

model log stream

example 481

peer connector

in recovery 516

read

log data in data set format 509

read from a log stream

browse cursor 496 browse session 496 browse token 496

IXGBRWSE service 495

recovery 515 application failure 515

coupling facility failure 517

coupling facility full 519

DASD log data set space fills 520

log stream damage 519 staging data set full 519

system failure 516 system logger address space failure 516

unrecoverable I/O errors 521

searching for a log block by time stamp

illustration 498

services

overview 469

staging data sets

formatting 494 storage limit reached 494

system logger (continued) status changes

ENF event code 48 480

summary 3

user data for a log stream 489

writing to a log stream

IXGWRITE service 491

system logger application

ENF event code 48 480

example 463

system logger configuration

set up 509

system logger services 463

64–bit virtual addressing support

example 472

authorization requirements 470

gaps in the log stream 475

IXGBRWSE service 495

browse cursor 496 browse session 496 browse token 496

MULTIBLOCK parameter 498

REQUEST=READBLOCK 496

REQUEST=READCURSOR 497

REQUEST=RESET 496

REQUEST=START 496

searching for a log block by time stamp 497

with IXGDELET service 500

with IXGWRITE service 499

IXGCONN service 486

allocating coupling facility space at connection 487

authorization requirements 488 connect process and staging data sets 488

disconnect from a log stream 489

import connection 488

user data for a log stream 489

BUFFALET parameter 491

BUFFKEY parameter 491

BUFFLEN parameter 492

committing data 493 coupling facility structure storage limit reached 493

log block buffer 491

sequence of log blocks 492

staging data set is formatting 494 staging data set storage limit reached 494

mode parameter 474

MODE=ASYNCNORESPONSE parameter 475

MODE=SYNC parameter 474

MODE=SYNCECB parameter 475

overview 469

searching for a log block by time stamp

illustration 498

synchronous and asynchronous processing 474

system logger applications 463

system resource

releasing through recovery 147

system-generated PICA 142

SYSUDUMP ABEND dump 195

T

target program

definition 5

task

advantage of creating additional 27

communication with subtasks 29

create 27

library, establishing 48

priority, affect on processing 28

synchronization 116

TASKLIB parameter of ATTACH 48, 49

tasks in a job step

illustration 30

TCB (task control block)

address 27

remove 30

temporary object

access to a temporary object, procedure for 341 accessing a temporary object 341 creating a temporary object 341

data transfer 335

defining a view 342

defining multiple views 345

functions supported for 339

extending the size 345

initialized value 334

mapping a window, example 336

obtaining

access to a temporary object,

overview 340, 341, 342

overview of supported function 339

refreshing, overview 340 saving changes, overview 340

scroll area 342

size of, maximum 333

specifying the object size 341

storage used for 334

structure 333

terminating access to a temporary object 350

updating a temporary object 347

terminate access to an object 350

terminate view of an object 348

time interval

TIME macro

time of day and date

timer synchronization

checking 385

TIMEUSED macro

using 388

TOD (time-of-day) clock

checking for synchronization with

ETR 385

converting value 386

Index

569

TOD (time-of-day) clock (continued)

obtaining content 385

token

used with GQSCAN macro 135

TRANMSG macro 411

Transaction dump 195

transactional execution 525

transactional execution debugging 528 transactional execution diagnostics 528

transfer data between hiperspace and address space 321

translate message 399

TTIMER macro

obtaining device information 439

U

UCB (unit control block)

scanning 438

UCBINFO macro 439

UCBSCAN macro 438

unit name 532 device class 532 is a look-up value function of unit verification service 532

unit verification service

description 531

examples 544

FLAGS parameter field 533

functions 531, 533, 534, 544

IEFEB4UV routine 533 input and output 533

data structure 534

parameter list required 533

purpose 531

requesting multiple functions 544

update a permanent object on

DASD 348

update a temporary object 347

UPDTMPB macro 414

use an entry to an access list

use count for a loaded module 59

use count 55

use data spaces efficiently 316

use of data space and hiperspace 297

user interface

ISPF 547

TSO/E 547

user list 261, 270, 272

use

using a memory object

use the storage 238

using transactional executiong 527

V

V-type address constant

use to pass control 42

570

z/OS MVS Assembler Services Guide

V=R (virtual=central) storage

allocation 359

VERBEXIT DAEDATA subcommand

indicating why dump was not suppressed 201

verification

device 531

version record

format 402

virtual storage

controlling 219

explicit requests for 214

freeing 225

implicit requests for 223

loading 360, 362

obtaining via CPOOL 218

page-ahead function 362 paging out 362

releasing 359, 360

sharing with IARVSERV macro 375

specifying the amount allocated to a

task 213, 214

subpool 219

using efficiently 213

why use above the bar 228

virtual storage window 257, 260

VRADATA macro

to customize dump suppression 200

using in a recovery environment 158

VSL (virtual subarea list) 363

VSM (virtual storage management) 213,

226

W

wait

bit 116 condition 116

long 117

WAIT macro

use 116

ways that window services can map an object 335

window

affect of terminating access to an object 350

blocks to be viewed, identifying 345

changing a view in a window 348

changing the view, overview 340

data to be viewed, identifying 345

defining

window, overview 340, 343, 344,

345, 346

identifying blocks to be viewed 345

identifying a window 343

mappping

to a window, example 335, 336,

337 multiple objects, example 337

multiple windows 345

refreshing a window 347

REPLACE option 343

RETAIN option 343 size 343 storage for 343

terminating a view in a window 348

window (continued)

to multiple windows, example 336

updating a permanent object from a window 348

use 333

window disposition 343

window reference pattern 344

windows with overlapping view 346

window service

introduction 333 overview 333

use 339

window services

functions provided 334

overview 333

services provided 334

using window services 339

ways to map an object 335

WLM goal mode

dispatching priority 28

work area

used by data compression service 419 used by data expansion service 419

write

to the operator with reply 388

to the operator without reply 391

to the programmer 393 to the system log 393

write connection

IXGCONN service

IMPORTCONNECT parameter 488

WRITE macro 445

write message 388

write operation

for standard hiperspace 321

write programs in AR mode 288

write to a standard hiperspace 322, 326

writing

to a log stream 491

WTL macro

writing to the system log 393

WTO macro

descriptor code for 390

example 391

MLWTO (multiple-line) form 389 single-line form 389

use 388

WTOR macro

example 392

use 388

X

X-macro

definition 293 rules for using 293

XCTL macro

addressing mode consideration 47

lowering the responsibility count 225

use 47, 58

use with branch instructions, danger 59

XCTLX macro

use 58

Z

z/Architecture

setting and checking the addressing mode 234

z/Architecture instructions

using the 64-bit GPR 231 z/Architecture processes S/390 instructions, how 231 examples 231

z/OS MVS Programming: Assembler

Services Guide

messages xvii

Index

571

572

z/OS MVS Assembler Services Guide

IBM®

Product Number: 5650-ZOS

Printed in USA

SA23-1368-30

/

Unduh

Hanya pengingat ramah. Anda dapat melihat dokumen di sini. Tetapi yang paling penting, AI kami telah membacanya. Ia dapat menjelaskan hal-hal kompleks dengan istilah sederhana, menjawab pertanyaan Anda dalam bahasa apa pun, dan membantu Anda menavigasi dengan cepat bahkan dokumen terpanjang atau paling rumit.

Tidak, saya masih ingin mencarinya sendiri

Halo! Saya adalah chatbot AI yang secara khusus dilatih untuk membantu Anda dengan Index. IBM z/OS Version 2 Release 3. Saya telah meninjau dokumen secara menyeluruh dan dapat membantu Anda menemukan informasi yang tepat yang Anda butuhkan atau menjelaskan konten dengan istilah yang jelas dan sederhana. Apakah Anda mencari panduan tentang fitur tertentu, langkah-langkah pemecahan masalah, atau penggunaan umum, jangan ragu untuk mengajukan pertanyaan Anda. Semakin banyak detail yang Anda berikan tentang kekhawatiran atau kebutuhan Anda, semakin akurat dan efektif saya dapat membantu Anda!

Asisten sedang mengetik

Asisten sedang tidak ada di depan keyboard. Silakan coba lagi nanti.

New chat

Daftar isi

About this information

Who should use this information

How to use this information

z/OS information

How to send your comments to IBM

15

If you have a technical problem

15

Summary of changes

Summary of changes for z/OS MVS Programming: Assembler Services Guide for z/OS Version 2 Release 3

Summary of changes for z/OS Version 2 Release 2 (V2R2), as updated December, 2015

Summary of changes for z/OS MVS Programming: Assembler Services Guide for z/OS Version 2 Release 2

z/OS Version 2 Release 1 summary of changes

18

Chapter 1. Introduction

19

Chapter 2. Linkage conventions

23

Saving the calling program's registers

24

Caller-provided save area

24

Linkage convention for floating point registers

Linkage convention for the floating point control register

System-provided linkage stack

Using the linkage stack

Example of using the linkage stack

26

Using a caller-provided save area

26

If not changing ARs or bits 0–31 of the 64–bit GPRs

27

Example

28

If changing the contents of bits 0-31 of the 64-bit GPRs but not changing ARs

If starting in AMODE 64

32

Example

33

If changing ARs without using the linkage stack

34

Example

36

Establishing a base register

37

Linkage procedures for primary mode programs

37

Primary mode programs receiving control

37

Primary mode programs returning control

39

Primary mode programs calling another program

39

Linkage procedures for AR mode programs

AR mode programs receiving control and using the linkage stack

AR mode programs returning control and using the linkage stack

AR mode programs receiving control and not using the linkage stack

AR mode programs returning control and not using the linkage stack

41

AR mode programs calling another program

41

Conventions for passing information through a parameter list

42

Program in primary ASC mode

42

Programs in AR mode

43

Chapter 3. Subtask creation and control

Address space priority

Assigning and changing priority

46

Stopping and restarting a subtask (STATUS macro)

47

Task and subtask communications

47

Chapter 4. Program management

51

Residency and addressing mode of programs

51

Residency mode definitions

51

Addressing mode definitions

52

Linkage considerations

52

Floating point considerations

53

Passing control between programs with the same AMODE

53

Passing control between programs with different AMODEs

53

Passing control between programs with all registers intact

54

Defining the entry characteristics of the target routine

55

Freeing dynamic storage associated with the caller

56

Load module structure types

Load module execution

Passing control in a simple structure

Passing control without return

Preparing to pass control

Passing control with return

Passing control

58

59

Preparing to pass control

How control is returned

62

Return to the control program

64

Passing control in a dynamic structure

65

Bringing the load module into virtual storage

65

Location of the load module

65

The search for the load module

66

Using an existing copy

70

Using the LOAD macro

71

Passing control with return

72

Using the LINK or LINKX macro

72

Using CALL, BALR, BASR, or BASSM

74

How control is returned

75

Passing control without return

76

Passing control using a branch instruction

76

Using the XCTL or XCTLX macro

76

APF-authorized programs and libraries

78

Additional Entry Points

79

Entry Point and Calling Sequence Identifiers as Debugging Aids

79

Retrieving Information About Loaded Modules

80

Using the CSVINFO macro

80

Serialization

82

Coding a MIPR for the CSVINFO macro

Recovery for MIPR provided by CSVINFO

Return specifications

83

Registers at exit

83

CSVINFO service coding example

84

Chapter 5. Understanding 31-bit addressing

85

Virtual storage

85

Addressing mode and residency mode

85

Requirements for execution in 31-bit addressing mode

87

Rules and conventions for 31-bit addressing

88

Mode sensitive instructions

88

BAL and BALR

88

Branching instructions

89

Use of 31-bit addressing

89

Planning for 31-bit addressing

90

Converting existing programs

90

Writing new programs that use 31-bit addressing

93

New programs below 16 megabytes

94

New programs above 16 megabytes

94

Writing programs for MVS/370 and MVS systems with 31-bit addressing

Addressing mode and residency mode

Addressing mode - AMODE

Residency mode - RMODE

AMODE and RMODE combinations

AMODE and RMODE combinations at execution time

Determining the AMODE and RMODE of a load module

97

Assembler support of AMODE and RMODE

97

AMODE and RMODE in the object module

97

AMODE and RMODE assembler instructions

98

Linkage editor and binder support of AMODE and RMODE

98

Linkage editor RMODE processing

101

Loader support for AMODE and RMODE

102

System support of AMODE and RMODE

103

How to change addressing mode

105

Establishing linkage

105

Using the BASSM and BSM instructions

107

Calling and returning with BASSM and BSM

109

Using pointer-defined linkage

110

Using an ADCON to obtain a pointer-defined value

110

Using the LOAD macro to obtain a pointer-defined value

112

Using supervisor-assisted linkage

112

Linkage assist routines

113

Example of using a linkage assist routine

114

Using capping - linkage using a prologue and epilogue

118

Performing I/O in 31-bit addressing mode

Example of performing I/O while residing above 16 megabytes

120

Understanding the use of central storage

129

Central storage considerations for user programs

129

Load real address (LRA) instruction

Chapter 6. Resource control

133

Synchronizing tasks (WAIT, POST, and EVENTS macros)

134

Synchronizing tasks (Pause, Release, and Transfer)

136

Pause elements and pause element tokens

136

Using the services

138

Serializing access to resources (ISGENQ macro)

141

Naming the resource

142

Defining the scope of a resource

143

Local and global resources

143

Determining the resulting scope

144

Requesting exclusive or shared control

144

Limiting concurrent requests for resources

145

Processing the requests

145

Duplicate requests for a resource

146

Releasing the resource

147

ENQ and DEQ conditional and unconditional requests

147

ISGENQ conditional and unconditional requests

148

Avoiding interlock

149

Serializing access to resources through the ISGENQ macro

150

Collecting information about resources and their requestors (ISGQUERY and GQSCAN macros)

151

How ISGQUERY returns resource information

151

How GQSCAN returns resource information

152

How area size determines the information GQSCAN returns

153

How scope and token values determine the information GQSCAN returns

153

How GRS determines the scope of an ENQ or RESERVE request

155

Chapter 7. Program interruption services

157

Specifying user exit routines

157

Using the SPIE macro

158

Program interruption control area

158

Program interruption element

159

Using the ESPIE macro

159

The extended program interruption element (EPIE)

160

Environment upon entry to user's exit routine

160

Functions performed in user exit routines

161

Requesting percolation from an ESPIE exit

161

Chapter 8. Providing recovery

163

Understanding general recovery concepts

164

Deciding whether to provide recovery

165

Understanding errors in MVS

166

Understanding recovery routine states

167

Understanding the various routines in a recovery environment

Choosing the appropriate recovery routine

168

Floating point implications

170

Summary of recovery routine states

170

Understanding recovery routine options

170

Understanding how routines in a recovery environment interact

171

Writing recovery routines

173

Understanding what recovery routines do

174

Saving the return address to the system

174

Checking for the SDWA

174

Establishing addressability to the parameter area

175

Checking important fields in the SDWA

175

Checking the contents of the parameter area

176

Saving serviceability data

176

Requesting a dump

176

Correcting or minimizing the error

177

Deciding to retry or percolate

177

Understanding the means of communication

180

Setting up, passing, and accessing the parameter area

180

Using the SDWA

183

Special considerations for ESTAE-type recovery routines

188

RB considerations

188

Linkage stack considerations

188

Outstanding I/Os at the time of failure

189

Additional considerations specific to ESTAE-type recovery routines

190

Using ARRs

191

Understanding the recovery environment

191

Register contents

192

Register contents on entry to a recovery routine

192

Register contents on return from a recovery routine

194

Register contents

195

Other environmental factors in recovery

198

Environment on entry to an ESTAE-type recovery routine

198

Environment on entry to a retry routine from an ESTAE-type recovery routine

200

Summary of environment on entry to an ESTAE-type recovery routine and its retry routine

201

Linkage stack at time of retry

202

Understanding recovery through a coded example

203

Understanding advanced recovery topics

206

Invoking RTM (ABEND macro)

206

Providing multiple recovery routines

207

Providing recovery for recovery routines

207

Providing recovery for multitasking programs

208

Using STAE/STAI routines

208

Chapter 9. Dumping virtual storage (ABEND, SNAPX, SNAP, and IEATDUMP macros)

213

ABEND dumps

214

Obtaining a symptom dump

214

Suppressing dumps that duplicate previous dumps

214

Symptoms provided by a recovery routine

217

When a dump is not suppressed

219

SNAP dumps

220

Finding information in a SNAP dump

220

Obtaining a summary dump for an ABEND or SNAP dump

220

Transaction dumps

221

Chapter 10. Reporting symptom records (SYMRBLD and SYMREC macros)

223

Writing symptom records to Logrec data set

223

The format of the symptom record

224

Symptom strings — SDB format

225

Building a symptom record using the SYMRBLD macro

225

Building a symptom record using the ADSR and SYMREC macros

226

Programming notes for section 1

226

Programming notes for section 2

227

Programming notes for section 2.1

227

Programming notes for section 3

229

Programming notes for section 4

229

Programming notes for section 5

230

Chapter 11. Virtual storage management

231

Explicit requests for virtual storage

232

Obtaining storage through the GETMAIN macro

232

Obtaining storage through the STORAGE macro

234

Releasing storage through the FREEMAIN and STORAGE macros

236

Using the CPOOL macro

236

Subpool handling

237

Implicit requests for virtual storage

241

Reenterable load modules

241

Reenterable macros

241

Non-reenterable load modules

243

Freeing of virtual storage

243

Chapter 12. Using the 64-bit address space

245

What is the 64-bit address space?

245

Why would you use virtual storage above the bar?

Using assembler instructions in the 64-bit address space

248

64-bit binary operations

248

How z/Architecture processes S/390 instructions

249

z/Architecture instructions that use the 64-bit GPR

249

64-bit addressing mode (AMODE)

250

Non-modal instructions

250

Modal instructions

251

Setting and checking the addressing mode

Issuing MVS macros in AMODE 64

253

Example of using SYSSTATE AMODE64=

253

IARV64 services

Protecting storage above the bar

Preventing execution of code from the memory object

Relationship between the memory object and its owner

Example of creating a memory object

Creating memory objects

255

255

Using a memory object

256

Discarding data in a memory object

258

Releasing the physical resources that back pages of memory objects

258

Freeing a memory object

259

Example of freeing a memory object

259

Creating a guard area and changing its size

259

Example of creating a memory object with a guard area

260

An example of creating, using, and freeing a memory object

261

Chapter 13. Callable cell pool services

263

Comparison of callable cell pool services and the CPOOL macro

264

Storage considerations

265

Link-editing callable cell pool services

266

Using callable cell pool services

267

Handling return codes

269

Callable cell pool services coding examples

269

Chapter 14. Data-in-virtual

275

When to use data-in-virtual

276

Factors affecting performance

276

Creating a linear data set

277

Using the services of data-in-virtual

Save, savelist, and reset

Effect of RETAIN mode on RESET

291

The UNMAP service

292

The UNACCESS and UNIDENTIFY services

293

Sharing data in an object

Miscellaneous restrictions for using data-in-virtual

DIV macro programming examples

General program description

Data-in-virtual sample program code

295

296

297

298

Chapter 15. Using access registers

299

Executing the program

300

303

Access lists

305

Types of access lists

305

Writing programs in AR mode

306

Coding instructions in AR mode

307

Manipulating the contents of ARs

308

Loading an ALET into an AR

309

Loading the value of zero into an AR

309

The ALESERV macro

309

Adding an entry to an access list

310

Deleting an entry from an access list

310

Issuing MVS macros in AR mode

311

Example of using SYSSTATE

311

Using X-macros

311

Formatting and displaying AR information

312

Chapter 16. Data spaces and hiperspaces

313

What are data spaces and hiperspaces?

313

What can a program do with a data space or a hiperspace?

How does a program obtain a data space and a hiperspace?

How does a program move data into a data space or hiperspace?

Who owns a data space or hiperspace?

Can an installation limit the use of data spaces and hiperspaces?

315

How does a program manage the storage in a data space or hiperspace?

315

Differences between data spaces and hiperspaces

316

Comparing data space and hiperspace use of physical storage

317

Which one should your program use?

317

An example of using a data space

318

An example of using a hiperspace

318

Creating and using data spaces

318

Manipulating data in a data space

319

Rules for creating, deleting, and managing data spaces

319

Creating a data space

320

Choosing the name of a data space

321

Specifying the size of a data space

321

Identifying the origin of a data space

323

Example of creating a data space

323

Establishing addressability to a data space

324

Examples of moving data into and out of a data space

324

Extending the current size of a data space

326

Releasing data space storage

327

Paging data space storage areas into and out of central storage

327

Deleting a data space

328

Using callable cell pool services to manage data space areas

328

Sharing data spaces among problem-state programs with PSW key 8-F

330

Sharing data spaces through the PASN-AL

332

Example of mapping a data-in-virtual object to a data space

332

Mapping a data-in-virtual object to a data space

333

Using data spaces efficiently

334

Example of creating, using, and deleting a data space

334

Dumping storage in a data space

335

Using checkpoint/restart

335

Creating and using hiperspaces

336

Standard hiperspaces

337

Shared and non-shared standard hiperspaces

338

Creating a hiperspace

338

Example of creating a standard hiperspace

339

Transferring data to and from hiperspaces

339

Read and write operations for standard hiperspaces

340

Obtaining additional HSPSERV performance

341

Extending the current size of a hiperspace

343

Releasing hiperspace storage

343

Deleting a hiperspace

344

Example of creating a standard hiperspace and using it

344

Using data-in-virtual with hiperspaces

346

Mapping a data-in-virtual object to a hiperspace

347

Using a hiperspace as a data-in-virtual object

348

Using checkpoint/restart

349

Chapter 17. Window services

Temporary data objects

351

Structure of a data object

351

What does window services provide?

352

The ways that window services can map an object

353

Example 1 — Mapping a permanent object that has no scroll area

353

Example 2 — Mapping a permanent object that has a scroll area

353

Example 3 — Mapping a temporary object

354

Example 4 — Mapping multiple windows to an object

354

Example 5 — Mapping multiple objects

355

Access to permanent data objects

356

Access to temporary data objects

357

Using window services

357

Obtaining access to a data object

359

Identifying the object

359

Specifying the object's size

359

Specifying the type of access

360

Obtaining a scroll area

360

Defining a view of a data object

360

Identifying the data object

361

Identifying a window

361

Defining the disposition of a window's contents

361

Defining the expected reference pattern

362

Identifying the blocks you want to view

363

Extending the size of a data object

363

Defining multiple views of an object

363

Non-overlapping views

364

Overlapping views

364

Saving interim changes to a permanent data object

364

Updating a temporary data object

365

Refreshing changed data

365

Updating a permanent object on DASD

When there is a scroll area

When there is no scroll area

Changing a view in a window

Terminating access to a data object

368

Link-editing callable window services

368

Window services coding example

369

Chapter 18. Sharing application data (name/token callable services)

371

Understanding name/token pairs and levels

371

Name/token pairs

371

Levels for name/token pairs

372

Determining what your program can do with name/token pairs

372

Deciding what name/token level you need

373

Task-level name/token pair

373

Home-level name/token pair

374

Owning and deleting name/token pairs

375

Using checkpoint/restart with name/token pairs

376

Link-editing name/token services

376

Chapter 19. Processor storage management

377

Freeing virtual storage

378

Releasing storage

378

Protecting a range of virtual storage pages

379

Loading/paging out virtual storage areas

380

Virtual subarea list

381

Page service list (PSL)

381

Defining the reference pattern (REFPAT)

382

How does the system handle the data in an array?

383

What pages does the system bring in when a gap exists?

384

Using the REFPAT macro

386

Identifying the data area and direction of reference

386

Defining the reference pattern

387

Choosing the number of bytes on a page fault

388

Examples of using REFPAT to define a reference pattern

390

Removing the definition of the reference pattern

390

Chapter 20. Sharing data in virtual storage (IARVSERV macro)

393

Understanding the concepts of sharing data with IARVSERV

394

Storage you can use with IARVSERV

394

Obtaining storage for the source and target

395

Defining storage for sharing data and access

395

Changing storage access

396

How to share and unshare data

398

Accessing data in a sharing group

399

Example of sharing storage with IARVSERV

399

Use with data-in-virtual (DIV macro)

400

Diagnosing problems with shared data

401

Converting a central to virtual storage address (IARR2V macro)

401

Chapter 21. Timing and communication

403

Checking for timer synchronization

403

Obtaining time of day and date

403

Converting between time of day and date and TOD clock formats

404

Interval timing

404

Obtaining accumulated processor time

406

Writing and deleting messages (WTO, WTOR, DOM, and WTL)

406

Routing the message

407

Altering message text

409

Writing a multiple-line message

410

Embedding label lines in a multiple-line message

Communicating in a sysplex environment

Writing to the programmer

Writing to the system log

Deleting messages already written

412

Retrieving console information (CONVCON and CnzConv macros)

412

Using console names instead of console IDs

413

Determining the name or ID of a console

413

Validating a console name or ID and obtaining the active system name

415

Chapter 22. Translating messages

417

Allocating data sets for an application

419

Creating install message files

420

Creating a version record

420

Creating message skeletons

420

Message skeleton format

421

Message text in a skeleton

422

Validating message skeletons

423

Allocating storage for validation run-time message files

424

Compiling message files

424

Invoking the message compiler

425

Checking the message compiler return codes

428

Updating the system run-time message files

428

Using MMS translation services in an application

429

Determining which languages are available (QRYLANG macro)

429

Retrieving translated messages (TRANMSG macro)

429

Example of displaying messages

431

Using message parameter blocks for new messages (BLDMPB and UPDTMPB macros)

432

Support for additional languages

433

Example of an application that uses MMS translation services

434

Chapter 23. Data compression and expansion services

437

Services provided by CSRCESRV

437

Using these services

438

Services provided by CSRCMPSC

438

Compression and expansion dictionaries

439

Building the CSRYCMPS area

439

Determining if the CSRCMPSC macro can be issued on a system

442

Compression processing

Compression dictionary entries

Character entry generic form (DSECT CMPSCDICT_CE)

Character entry CCT=0 (DSECT CMPSCDICT_CE)

Character entry CCT=1 (DSECT CMPSCDICT_CE)

Character entry CCT>1 (DSECT CMPSCDICT_CE)

445

Alphabet entries (DSECT CMPSCDICT_CE)

Format 1 sibling descriptor (DSECT CMPSCDICT_SD)

Expansion dictionary entries

Unpreceded entry (DSECT CMPSCDICT_UE)

Preceded entry (DSECT CMPSCDICT_PE)

447

Sibling descriptor extension entry (DSECT CMPSCDICT_SDE)

447

Dictionary restrictions

447

Other considerations

448

Compression dictionary examples

448

Example 1

448

Example 2 for more than 5 children

450

Example 3 for children with the same value

452

Expansion dictionary example

453

Chapter 24. Accessing unit control blocks (UCBs)

455

Detecting I/O configuration changes

455

Scanning UCBs

456

Obtaining UCB information for a specified device

457

Obtaining eligible device table information

457

Using the EDTINFO macro

458

Chapter 25. Setting up and using an internal reader

461

Allocating the internal reader data set

461

Opening the internal reader data set

462

Sending job output to the internal reader

463

Obtaining a job identifier

463

Closing the internal reader data set

464

Chapter 26. Using the symbol substitution service

Examples of user symbols

468

Calling the ASASYMBM or ASASYMBF service

469

Setting up the ASASYMBP mapping macro

469

Providing a symbol table to ASASYMBM / ASASYMBF

471

Setting up the symbol table

472

Rules for entering symbols in the symbol table

475

Using symbols in programs

Chapter 27. Using system logger services

481

What is system logger?

481

The log stream

482

Coupling facility log stream

483

DASD-only log stream

484

The system logger configuration

484

The system logger component

486

Overview of system logger services

487

Summary of system logger services

487

Define authorization to system logger resources

488

Authorization for system logger application programs

489

64 bit virtual addressing support for system logger services

489

Synchronous and asynchronous processing

492

How system logger handles gaps in the log stream

493

Dumping on data loss (804–type) conditions

494

Define a log stream to allow additional dumping

495

Define a log stream to allow additional dumping using LIKE

495

Update a log stream to allow additional dumping

495

Connect to a log stream and request additional dumping

Browsing a log stream and request additional dumping

Deleting log data from a log stream and request additional dumping

Using the system logger answer area (ANSAREA parameter)

Using ENF event code 48 in system logger applications

498

IXGINVNT: Managing the LOGR policy

498

Defining a model log stream in the LOGR couple data set

498

Defining a log stream as DASD-only

499

Upgrading an existing log stream configuration

500

Upgrading a log stream from DASD-only to coupling facility

500

Updating an existing structure-based log stream to another structure

501

Renaming a log stream dynamically

502

Updating a log stream's attributes

502

IXGCONN: Connecting to and disconnecting from a log stream

504

Examples of ways to connect to the log stream

504

Additional considerations for connecting to a DASD-only log stream

505

How system logger allocates structure space for a new log stream at connection time

505

Connect process and staging data sets

506

Requesting authorization to the log stream for an application

506

Requesting a write or import connection - IMPORTCONNECT parameter

506

Specifying user data for a log stream

System logger processing at disconnection and expired stream token

Disconnection for an application

Last disconnection for log stream on a system

Last disconnection for a system in the sysplex

508

Expired log stream token

508

IXGWRITE: Writing to a log stream

509

The log block buffer

509

Ensuring chronological sequence of log blocks

510

Write triggers

510

When is data committed to the log stream?

511

When the log stream coupling facility storage limit is reached

511

When the staging data set storage limit is reached

512

When the staging data set is formatting

512

Limiting asynchronous IXGWRITE requests

513

IXGBRWSE: Browsing/reading a log stream

Browsing both active and inactive data

515

Browsing for a log block by time stamp

515

Browsing multiple log blocks

516

Return and reason code considerations

517

Using IXGBRWSE and IXGWRITE

517

Using IXGBRWSE and IXGDELET requests together

518

IXGDELET: Deleting log blocks from a log stream

518

Using the BLOCKS parameter

518

IXGIMPRT: Import log blocks

519

Making sure log blocks are imported in sequence - Understanding log block identifiers

519

How do I know what the length of the control information is?

520

Example: How log block identifiers are generated

520

Making sure log data is safe to import

520

IXGQUERY: Get information about a log stream or system logger

521

The safe import point: Using IXGQUERY and IXGIMPRT together

522

Coupling facility log streams and the safe import point

522

DASD-only log streams and the safe import point

524

The coupling facility list structure version number

524

Using the coupling facility version number

525

IXGOFFLD: Initiate offload to DASD log data sets

525

Managing a target log stream: Using IXGIMPRT, IXGOFFLD, and IXGQUERY together

525

IXGUPDAT: Modify log stream control information

526

Rebuilds and IXGUPDAT processing

Setting up the system logger configuration

Reading data from log streams in data set format

Is my application eligible for the LOGR subsystem?

Preparing to use the LOGR subsystem

528

Using the LOGR subsystem

528

JCL for the LOGR Subsystem

529

LOGR SUBSYS dynamic allocation considerations

531

When things go wrong — Recovery scenarios for system logger

533

When a system logger application fails

533

When an MVS system or sysplex fails

534

Recovery performed for DASD-only log streams

534

When the system logger address space fails

534

When the coupling facility structure fails

535

Damage to or failure of the coupling facility structure

535

Loss of connectivity to the coupling facility structure

536

A coupling facility becomes volatile

536

When the coupling facility space for a log stream becomes full

537

When a staging data set becomes full

537

When a log stream is damaged

537

When DASD log data set space fills

538

When unrecoverable DASD I/O errors occur

539

When unrecoverable DASD I/O errors occur during offload

539

When staging data set unrecoverable DASD I/O errors occur

539

Chapter 28. Unicode instruction services: CSRUNIC

541

Chapter 29. Transactional execution

543

Nonconstrained transactions

543

Constrained transactions

544

Planning to use transactional execution

545

Transactional execution debugging

546

Transactional execution diagnostics

546

Appendix A. Using the unit verification service

Functions of unit verification

Check groups - Function code 0

Check units - Function code 1

Return unit name - Function code 2

Return unit control block (UCB) addresses - Function code 3

Return group ID - Function code 4

Indicate unit name is a look-up value - Function code 5

Return look-up value - Function code 6

Convert device type to look up value - Function code 7

Return attributes - Function code 8

Specify subpool for returned storage - Function code 10

Return unit names for a device class - Function code 11

Input to and output from unit verification service routines

Callers of IEFEB4UV

551

551

Input parameter list

551

Input and output data structures

552

Register 15 if request fails

553

Requesting function code 0 (check groups)

553

Requesting function code 1 (check units)

553

Requesting function code 2 (return unit name)

554

Requesting function code 3 (return UCB addresses)

555

Requesting function code 4 (return group ID)

556

Requesting function code 5 (indicate unit name is a look-up value)

557

Requesting function code 6 (return look-up value)

558

Requesting function code 7 (convert device type to look-up value)

559

Requesting function code 8 (return attributes)

559

Requesting function code 10 (specify subpool for returned storage)

560

Requesting function code 11 (return unit names for a device class)

561

Requesting multiple functions - Examples

562

Example 1 - Function codes 0 and 1

562

Example 2 - Function codes 3 and 10

563

Example 3 - Function codes 1 and 5

564

Appendix B. Accessibility

Accessibility features

Consult assistive technologies

Keyboard navigation of the user interface

Dotted decimal syntax diagrams