Manuals / IBM / TV and Video / Universal Remote

IBM Version 4 manual Internal Identifiers, Spooling, Security Uses

Models: Version 4

1 505
Download 505 pages 30.92 Kb
Page 32
Image 32

C

Z-ADDð

RETCOD

C

ELSE

 

C'CPF1Fð2' IFEQ ERRID

C'CPF1F22' OREQ ERRID

C\ \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

C\ THERE IS NO NEED TO REINITIALIZE THE ERROR CODE PARAMETE￿R.

C\ ONLY BYTES PROVIDED IS INPUT TO THE API; IT WILL RESET THE￿

C\ ERROR CODE PARAMETER FOR US. AFTER THE CALL TO QHFCRTDR,

C\ BYTES AVAILABLE WILL EITHER BE ð IF SUCCESSFUL OR NONZER￿O

C\ IF THE CREATE FAILS. WE DO NOT HAVE TO WORRY ABOUT THE

C\ PREVIOUS ERROR CODE BEING LEFT IN THE ERROR CODE PARAMET￿ER.

C\ \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

C

 

CALL 'QHFCRTDR'

 

 

C

 

PARM

PATHNM

 

C

 

PARM 2ð

PATHLN

 

C

 

PARM

ATTR

1

C

 

PARM ð

ATTRLN

 

C

 

PARM

ERROR

 

C

BYTAVA

IFEQ \ZERO

 

 

C

 

Z-ADDð

RETCOD

 

C

 

ELSE

 

 

C

 

Z-ADD1

RETCOD

 

C

 

END

 

 

C\

 

 

 

 

C

 

ELSE

 

 

C

 

Z-ADD1

RETCOD

 

C

 

END

 

 

C

 

END

 

 

C\

 

 

 

 

C\ PROGRAM END

 

 

 

C\

 

 

 

 

C

 

SETON

 

LR

Related Information

Ÿ“Retrieving the Hold Parameter (Exception Message)—OPM RPG Example” on

page 3-6

Ÿ “Error Handling” on page 4-5

ŸThe “API Error Reporting” topic in ChapterSystem 2APIofReferencethe , SC41-5801

Internal Identifiers

You

know of jobs, spooled files,

and

so forth,

by

their

names. The

sy

ID

that

is

associated

with

the

name. The

ID

is

assigned

based

on

 

of the APIs either require

or allow you to use an internal ID. When

internal ID, it is generally

faster because the system

does not

have

external

name

to

the internal

ID.

 

 

 

 

 

 

 

 

 

A variety

of

terminology

is used

to identify internal IDs. For example

Ÿ

Work Management uses internalan

job

identifier.

 

 

 

 

 

 

Ÿ

Spooling

 

uses internalan

spooled file .identifier

 

 

 

 

 

 

Ÿ

Security

uses

thehandlet rm to

mean

the

user

profile

that

is

currently

r

the job.

ŸMessage handling uses themessageterm key(also appears on CL com-

mands) to identify a message in a message queue.

The internal values are often accessed in one API and then used in a example, if you want a list of jobs, you would use the List Jobs ( which provides the internal job ID for each job in the list. You co

2-12System API Programming V4R1

Page 31 Page 33
Page 32
Image 32
IBM Version 4 manual Internal Identifiers, Spooling, Security Uses
Page 31 Page 33