z/OS

C/C++User’s

Guide

SC09-4767-03

���

z/OS

C/C++User’s

Guide

SC09-4767-03

���

Note!

Before

using

this

information

and

the

product

it

supports,

be

sure

to

read

the

information

in

“Notices”

on

page

623.

Fourth

Edition

(September

2004)

This

edition

applies

to

Version

1

Release

6

of

z/OS

C/C++

(5694-A01),

Version

1

Release

6

of

z/OS.e

(5655-G52),

and

to

all

subsequent

releases

until

otherwise

indicated

in

new

editions.

This

edition

replaces

SC09-4767-02

.

Make

sure

that

you

use

the

correct

edition

for

the

level

of

the

program

listed

above.

Also,

ensure

that

you

apply

all

necessary

PTFs

for

the

program.

Order

publications

through

your

IBM

representative

or

the

IBM

branch

office

serving

your

location.

Publications

are

not

stocked

at

the

address

below.

You

can

also

browse

the

books

on

the

World

Wide

Web

by

clicking

on

″The

Library″

link

on

the

z/OShome

page.

The

web

address

for

this

page

is

http://www.ibm.com/servers/eserver/zseries/zos/bkserv

IBM

welcomes

your

comments.

You

can

send

your

comments

to

the

following

Internet

address:

compinfo@ca.ibm.com.

Be

sure

to

include

your

e-mail

address

if

you

want

a

reply.

Include

the

title

and

order

number

of

this

book,

and

the

page

number

or

topic

related

to

your

comment.

When

you

send

information

to

IBM,

you

grant

IBM

a

nonexclusive

right

to

use

or

distribute

the

information

in

any

way

it

believes

appropriate

without

incurring

any

obligation

to

you.

©

Copyright

International

Business

Machines

Corporation

1996,

2004.

All

rights

reserved.

US

Government

Users

Restricted

Rights

–

Use,

duplication

or

disclosure

restricted

by

GSA

ADP

Schedule

Contract

with

IBM

Corp.

Contents

About

this

document

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. xv

How

to

read

syntax

diagrams

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. xv

Symbols

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. xv

Syntax

items

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. xv

Syntax

examples

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. xvi

z/OS

C/C++

and

related

publications

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. xvii

Softcopy

documents

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. xxii

Softcopy

examples

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. xxii

z/OS

C/C++

on

the

World

Wide

Web

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. xxiii

Where

to

find

more

information

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. xxiii

Part

1.

Introduction

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 1

Chapter

1.

About

IBM

z/OS

C/C++

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 3

Changes

for

z/OS

V1R6

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 3

The

C/C++

compilers

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 5

The

C

language

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 5

The

C++

language

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 5

Common

features

of

the

z/OS

C

and

C++

compilers

.

.

.

.

.

.

.

.

.

. 5

z/OS

C

Compiler

specific

features

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 7

z/OS

C++

Compiler

specific

features

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 7

Class

libraries

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 7

Utilities

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 7

dbx

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 8

z/OS

Language

Environment

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 8

z/OS

Language

Environment

downward

compatibility

.

.

.

.

.

.

.

.

.

. 9

About

prelinking,

linking,

and

binding

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 10

Notes

on

the

prelinking

process

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 10

File

format

considerations

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 11

The

program

management

binder

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 11

z/OS

UNIX

System

Services

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 12

z/OS

C/C++

Applications

with

z/OS

UNIX

System

Services

C/C++

functions

13

Input

and

output

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 14

I/O

interfaces

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 14

File

types

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 14

Additional

I/O

features

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 15

The

System

Programming

C

facility

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 16

Interaction

with

other

IBM

products

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 16

Additional

features

of

z/OS

C/C++

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 18

Part

2.

User’s

reference

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 21

Chapter

2.

z/OS

C

example

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 23

Example

of

a

C

program

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 23

CCNUAAM

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 23

CCNUAAN

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 24

Compiling,

binding,

and

running

the

z/OS

C

example

.

.

.

.

.

.

.

.

.

.

. 25

Under

z/OS

batch

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 25

Non-XPLINK

and

XPLINK

under

TSO

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 26

Non-XPLINK

and

XPLINK

under

the

z/OS

UNIX

System

Services

shell

.

.

. 27

Chapter

3.

z/OS

C++

examples

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 29

©

Copyright

IBM

Corp.

1996,

2004

iii

||

||

Example

of

a

C++

program

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 29

CCNUBRH

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 30

CCNUBRC

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 32

Compiling,

binding,

and

running

the

z/OS

C++

example

.

.

.

.

.

.

.

.

.

. 34

Under

z/OS

batch

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 34

Non-XPLINK

and

XPLINK

under

TSO

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 35

Non-XPLINK

and

XPLINK

under

the

z/OS

UNIX

shell

.

.

.

.

.

.

.

.

. 37

Example

of

a

C++

template

program

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 37

CLB3ATMP.CXX

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 38

Compiling,

binding,

and

running

the

C++

template

example

.

.

.

.

.

.

.

. 39

Under

z/OS

batch

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 39

Under

TSO

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 41

Under

the

z/OS

UNIX

shell

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 42

Chapter

4.

Compiler

Options

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 43

Specifying

compiler

options

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 43

IPA

considerations

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 44

Using

special

characters

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 46

Specifying

z/OS

C

compiler

options

using

#pragma

options

.

.

.

.

.

.

. 47

Specifying

compiler

options

under

z/OS

UNIX

System

Services

.

.

.

.

.

. 47

Compiler

option

defaults

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 48

Summary

of

compiler

options

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 50

Compiler

options

for

file

management

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 54

Options

that

control

the

preprocessor

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 55

Options

that

control

the

processing

of

an

input

source

file

.

.

.

.

.

.

.

.

. 55

Options

that

control

the

compiler

listing

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 56

Options

that

control

the

IPA

object

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 57

Options

that

control

the

IPA

Link

step

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 57

Options

for

debugging

and

diagnosing

errors

.

.

.

.

.

.

.

.

.

.

.

.

.

. 58

Options

that

control

the

programming

language

characteristics

.

.

.

.

.

.

. 59

Options

that

control

object

code

generation

.

.

.

.

.

.

.

.

.

.

.

.

.

. 60

Options

that

control

program

execution

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 63

Portability

options

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 63

Description

of

compiler

options

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 63

AGGRCOPY

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 64

AGGREGATE

|

NOAGGREGATE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 65

ALIAS

|

NOALIAS

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 66

ANSIALIAS

|

NOANSIALIAS

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 67

ARCHITECTURE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 70

ARGPARSE

|

NOARGPARSE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 73

ASCII

|

NOASCII

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 74

ATTRIBUTE

|

NOATTRIBUTE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 75

BITFIELD(SIGNED)

|

BITFIELD(UNSIGNED)

.

.

.

.

.

.

.

.

.

.

.

.

. 76

CHARS(SIGNED)

|

CHARS(UNSIGNED)

.

.

.

.

.

.

.

.

.

.

.

.

.

. 76

CHECKOUT

|

NOCHECKOUT

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 77

COMPACT

|

NOCOMPACT

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 79

COMPRESS

|

NOCOMPRESS

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 81

CONVLIT

|

NOCONVLIT

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 82

CSECT

|

NOCSECT

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 84

CVFT

|

NOCVFT

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 86

DBRMLIB

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 88

DEBUG

|

NODEBUG

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 88

DEFINE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 92

DIGRAPH

|

NODIGRAPH

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 93

DLL

|

NODLL

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 95

ENUMSIZE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 97

iv

z/OS

V1R6.0

C/C++

User’s

Guide

EVENTS

|

NOEVENTS

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 99

EXECOPS

|

NOEXECOPS

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 100

EXH

|

NOEXH

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 101

EXPMAC

|

NOEXPMAC

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 102

EXPORTALL

|

NOEXPORTALL

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 103

FASTTEMPINC

|

NOFASTTEMPINC

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 103

FLAG

|

NOFLAG

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 104

FLOAT

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 105

GOFF

|

NOGOFF

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 110

GONUMBER

|

NOGONUMBER

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 111

HALT(num)

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 112

HALTONMSG

|

NOHALTONMSG

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 113

IGNERRNO

|

NOIGNERRNO

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 114

INFO

|

NOINFO

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 115

INITAUTO

|

NOINITAUTO

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 116

INLINE

|

NOINLINE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 118

INLRPT

|

NOINLRPT

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 121

IPA

|

NOIPA

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 122

KEYWORD

|

NOKEYWORD

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 130

LANGLVL

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 131

LIBANSI

|

NOLIBANSI

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 142

LIST

|

NOLIST

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 143

LOCALE

|

NOLOCALE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 145

LONGNAME

|

NOLONGNAME

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 147

LP64

|

ILP32

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 148

LSEARCH

|

NOLSEARCH

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 150

MARGINS

|

NOMARGINS

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 156

MAXMEM

|

NOMAXMEM

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 157

MEMORY

|

NOMEMORY

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 158

NAMEMANGLING

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 159

NESTINC

|

NONESTINC

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 161

OBJECT

|

NOOBJECT

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 162

OBJECTMODEL

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 163

OE

|

NOOE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 165

OFFSET

|

NOOFFSET

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 166

OPTFILE

|

NOOPTFILE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 167

OPTIMIZE

|

NOOPTIMIZE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 169

PHASEID

|

NOPHASEID

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 172

PLIST

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 173

PORT

|

NOPORT

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 174

PPONLY

|

NOPPONLY

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 175

REDIR

|

NOREDIR

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 178

RENT

|

NORENT

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 179

ROCONST

|

NOROCONST

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 180

ROSTRING

|

NOROSTRING

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 181

ROUND

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 182

RTTI

|

NORTTI

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 183

SEARCH

|

NOSEARCH

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 184

SEQUENCE

|

NOSEQUENCE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 185

SERVICE

|

NOSERVICE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 186

SHOWINC

|

NOSHOWINC

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 187

SOURCE

|

NOSOURCE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 188

SPILL

|

NOSPILL

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 189

SQL

|

NOSQL

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 191

SSCOMM

|

NOSSCOMM

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 192

START

|

NOSTART

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 193

Contents

v

STATICINLINE

|

NOSTATICINLINE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 194

STRICT

|

NOSTRICT

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 195

STRICT_INDUCTION

|

NOSTRICT_INDUCTION

.

.

.

.

.

.

.

.

.

.

. 196

SUPPRESS

|

NOSUPPRESS

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 197

TARGET

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 197

TEMPINC

|

NOTEMPINC

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 203

TEMPLATERECOMPILE

|

NOTEMPLATERECOMPILE

.

.

.

.

.

.

.

. 204

TEMPLATEREGISTRY

|

NOTEMPLATEREGISTRY

.

.

.

.

.

.

.

.

.

. 205

TERMINAL

|

NOTERMINAL

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 206

TEST

|

NOTEST

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 206

TMPLPARSE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 211

TUNE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 212

UNDEFINE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 214

UNROLL

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 215

UPCONV

|

NOUPCONV

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 216

WARN64

|

NOWARN64

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 216

WSIZEOF

|

NOWSIZEOF

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 217

XPLINK

|

NOXPLINK

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 218

XREF

|

NOXREF

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 222

Using

the

z/OS

C

Compiler

Listing

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 223

IPA

Considerations

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 223

Example

of

a

C

Compiler

Listing

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 223

z/OS

C

Compiler

Listing

Components

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 254

Using

the

z/OS

C++

Compiler

Listing

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 257

IPA

Considerations

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 258

Example

of

a

C++

Compiler

Listing

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 258

z/OS

C++

Compiler

Listing

Components

.

.

.

.

.

.

.

.

.

.

.

.

.

. 268

Using

the

IPA

Link

Step

Listing

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 272

Example

of

an

IPA

Link

Step

Listing

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 272

IPA

Link

Step

Listing

Components

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 279

Chapter

5.

Binder

options

and

control

statements

.

.

.

.

.

.

.

.

.

. 285

Chapter

6.

Run-Time

options

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 287

Specifying

run-time

options

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 287

Using

the

#pragma

runopts

preprocessor

directive

.

.

.

.

.

.

.

.

.

. 287

Part

3.

Compiling,

binding,

and

running

z/OS

C/C++

programs

.

.

.

.

.

.

.

. 289

Chapter

7.

Compiling

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 291

Input

to

the

z/OS

C/C++

compiler

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 291

Primary

input

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 291

Secondary

input

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 292

Output

from

the

compiler

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 292

Specifying

output

files

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 292

Valid

input/output

file

types

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 295

Compiling

under

z/OS

batch

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 296

Using

cataloged

procedures

for

z/OS

C

.

.

.

.

.

.

.

.

.

.

.

.

.

. 297

Using

cataloged

procedures

for

z/OS

C++

.

.

.

.

.

.

.

.

.

.

.

.

. 298

Using

special

characters

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 298

Examples

of

compiling

programs

using

your

own

JCL

.

.

.

.

.

.

.

.

.

. 299

Specifying

source

files

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 301

Specifying

include

files

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 302

Specifying

output

files

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 302

Compiling

under

TSO

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 303

Using

the

CC

and

CXX

REXX

EXECs

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 303

vi

z/OS

V1R6.0

C/C++

User’s

Guide

||

Specifying

sequential

and

partitioned

data

sets

.

.

.

.

.

.

.

.

.

.

. 304

Specifying

HFS

files

or

directories

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 304

Compiling

and

binding

in

the

UNIX

System

Services

environment

.

.

.

.

.

. 305

Compiling

without

binding

using

compiler

invocation

command

names

supported

by

c89

and

xlc

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 307

Compiling

and

binding

in

one

step

using

compiler

invocation

command

names

supported

by

c89

and

xlc

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 309

Building

an

application

with

XPLINK

using

the

c89

or

xlc

utilities

.

.

.

.

. 310

Building

a

64-bit

application

using

the

c89

or

xlc

utilities

.

.

.

.

.

.

.

. 310

Invoking

IPA

using

the

c89

or

xlc

utilities

.

.

.

.

.

.

.

.

.

.

.

.

.

. 310

Using

IPA(OBJONLY)

with

the

c89

or

xlc

utilities

.

.

.

.

.

.

.

.

.

.

. 311

Using

the

make

utility

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 311

Compiling

with

IPA

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 312

The

IPA

Compile

step

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 312

The

IPA

Link

step

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 313

Compiling

with

IPA(OBJONLY)

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 314

Working

with

object

files

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 315

Browsing

object

files

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 315

Identifying

object

file

variations

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 316

Using

feature

test

macros

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 316

Using

include

files

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 316

Specifying

include

file

names

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 317

Forming

file

names

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 317

Forming

data

set

names

with

LSEARCH

|

SEARCH

options

.

.

.

.

.

.

. 318

Search

sequence

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 320

Determining

whether

the

file

name

is

in

absolute

form

.

.

.

.

.

.

.

.

. 321

Using

SEARCH

and

LSEARCH

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 323

Search

sequences

for

include

files

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 324

With

the

NOOE

option

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 325

With

the

OE

option

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 325

Compiling

z/OS

C

source

code

using

the

SEARCH

option

.

.

.

.

.

.

. 326

Compiling

z/OS

C++

source

code

using

the

SEARCH

option

.

.

.

.

.

. 327

Chapter

8.

Using

the

IPA

Link

step

with

z/OS

C/C++

programs

.

.

.

.

. 329

Creating

a

module

with

IPA

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 329

Example

1.

all

C

parts

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 329

Example

2.

all

C

parts

built

with

XPLINK

.

.

.

.

.

.

.

.

.

.

.

.

.

. 340

Creating

a

DLL

with

IPA

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 341

Example

1.

a

mixture

of

C

and

C++

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 342

Example

2.

using

the

IPA

control

file

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 344

Using

Profile-Directed

Feedback

(PDF)

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 345

Steps

for

completing

the

PDF

process

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 345

Steps

for

building

a

module

in

USS

using

PDF

.

.

.

.

.

.

.

.

.

.

.

. 347

Reference

Information

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 348

Invoking

IPA

from

the

c89

utility

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 348

IPA

Link

step

control

file

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 349

Object

file

directives

understood

by

IPA

.

.

.

.

.

.

.

.

.

.

.

.

.

. 352

Troubleshooting

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 352

Chapter

9.

Binding

z/OS

C/C++

programs

.

.

.

.

.

.

.

.

.

.

.

.

.

. 355

When

you

can

use

the

binder

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 355

When

you

cannot

use

the

binder

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 355

Your

output

is

a

PDS,

not

a

PDSE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 355

CICS

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 355

MTF

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 355

IPA

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 355

Contents

vii

||

Using

different

methods

to

bind

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 356

Single

final

bind

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 356

Bind

each

compile

unit

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 357

Build

and

use

a

DLL

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 358

Rebind

a

changed

compile

unit

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 360

Binding

under

z/OS

UNIX

System

Services

.

.

.

.

.

.

.

.

.

.

.

.

.

. 360

z/OS

UNIX

System

Services

example

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 361

Steps

for

single

final

bind

using

c89

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 361

Steps

for

binding

each

compile

unit

using

c89

.

.

.

.

.

.

.

.

.

.

.

. 362

Steps

for

building

and

using

a

DLL

using

c89

.

.

.

.

.

.

.

.

.

.

.

. 363

Steps

for

rebinding

a

changed

compile

unit

using

c89

.

.

.

.

.

.

.

.

. 364

Using

the

non-XPLINK

version

of

the

Standard

C++

Library

and

c89

.

.

. 365

Binding

under

z/OS

batch

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 366

z/OS

batch

example

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 366

Steps

for

single

final

bind

under

z/OS

batch

.

.

.

.

.

.

.

.

.

.

.

.

. 367

Steps

for

binding

each

compile

unit

under

z/OS

batch

.

.

.

.

.

.

.

.

. 368

Steps

for

building

and

using

a

DLL

under

z/OS

batch

.

.

.

.

.

.

.

.

. 369

Build

and

use

a

64-bit

application

under

z/OS

batch

.

.

.

.

.

.

.

.

.

. 370

Build

and

use

a

64-bit

application

with

IPA

under

z/OS

batch

.

.

.

.

.

. 371

Using

the

non-XPLINK

version

of

the

Standard

C++

Library

and

z/OS

batch

374

Steps

for

rebinding

a

changed

compile

unit

under

z/OS

batch

.

.

.

.

.

. 375

Writing

JCL

for

the

binder

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 375

Binding

under

TSO

using

CXXBIND

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 377

TSO

example

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 379

Steps

for

single

final

bind

under

TSO

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 379

Steps

for

binding

each

compile

unit

under

TSO

.

.

.

.

.

.

.

.

.

.

. 380

Steps

for

building

and

using

a

DLL

under

TSO

.

.

.

.

.

.

.

.

.

.

.

. 380

Steps

for

rebinding

a

changed

compile

unit

under

TSO

.

.

.

.

.

.

.

. 381

Chapter

10.

Binder

processing

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 383

Linkage

considerations

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 384

Primary

input

processing

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 385

C

or

C++

object

module

as

input

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 385

Secondary

input

processing

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 385

Load

module

as

input

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 385

Program

object

as

input

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 385

Autocall

input

processing

(library

search)

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 386

Incremental

autocall

processing

(AUTOCALL

control

statement)

.

.

.

.

. 386

Final

autocall

processing

(SYSLIB)

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 386

LP64

libraries

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 387

Rename

processing

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 388

Generating

aliases

for

automatic

library

call

(library

search)

.

.

.

.

.

.

. 388

Dynamic

Link

Library

(DLL)

processing

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 389

Statically

bound

functions

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 389

Imported

variables

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 390

Imported

functions

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 390

Output

program

object

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 390

Output

IMPORT

statements

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 390

Output

listing

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 390

Header

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 392

Input

Event

Log

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 392

Module

Map

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 393

Cross

Reference

Table

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 395

Imported

and

Exported

Symbols

Listing

.

.

.

.

.

.

.

.

.

.

.

.

.

. 395

Mangled

to

Demangled

Symbol

Cross

Reference

.

.

.

.

.

.

.

.

.

.

. 396

Processing

Options

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 397

viii

z/OS

V1R6.0

C/C++

User’s

Guide

||||

||

Save

Operation

Summary

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 397

Save

Module

Attributes

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 397

Entry

Point

and

Alias

Summary

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 398

Long

Symbol

Abbreviation

Table

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 398

DDname

vs

Pathname

Cross

Reference

Table

.

.

.

.

.

.

.

.

.

.

.

. 399

Message

Summary

Report

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 399

Binder

processing

of

C/C++

object

to

program

object

.

.

.

.

.

.

.

.

.

. 400

Rebindability

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 401

Error

recovery

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 403

Unresolved

symbols

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 403

Significance

of

library

search

order

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 404

Duplicates

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 405

Duplicate

functions

from

autocall

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 407

Hunting

down

references

to

unresolved

symbols

.

.

.

.

.

.

.

.

.

.

. 407

Incompatible

linkage

attributes

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 407

Non-reentrant

DLL

problems

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 408

Code

that

has

been

prelinked

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 408

Chapter

11.

Running

a

C

or

C++

application

.

.

.

.

.

.

.

.

.

.

.

.

. 409

Setting

the

region

size

for

z/OS

C/C++

applications

.

.

.

.

.

.

.

.

.

.

. 409

Running

an

application

under

z/OS

batch

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 410

Specifying

run-time

options

under

z/OS

batch

.

.

.

.

.

.

.

.

.

.

.

. 410

Specifying

run-time

options

in

the

EXEC

statement

.

.

.

.

.

.

.

.

.

. 411

Using

cataloged

procedures

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 411

Running

an

application

under

TSO

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 412

Specifying

run-time

options

under

TSO

.

.

.

.

.

.

.

.

.

.

.

.

.

. 413

Passing

arguments

to

the

z/OS

C/C++

application

.

.

.

.

.

.

.

.

.

. 413

Running

an

application

under

z/OS

UNIX

System

Services

.

.

.

.

.

.

.

. 414

z/OS

UNIX

System

Services

Application

environments

.

.

.

.

.

.

.

.

. 414

Specifying

run-time

options

under

z/OS

UNIX

System

Services

.

.

.

.

. 415

Restriction

on

using

24-bit

AMODE

programs

.

.

.

.

.

.

.

.

.

.

.

. 415

Copying

applications

between

a

PDS

and

HFS

.

.

.

.

.

.

.

.

.

.

. 415

Running

a

data

Set

member

from

the

z/OS

Shell

.

.

.

.

.

.

.

.

.

.

. 415

Running

z/OS

UNIX

System

Services

applications

under

z/OS

batch

.

.

. 415

Part

4.

Utilities

and

tools

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 419

Chapter

12.

Object

Library

Utility

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 421

Creating

an

object

library

under

z/OS

batch

.

.

.

.

.

.

.

.

.

.

.

.

.

. 421

Creating

an

object

library

under

TSO

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 422

Object

Library

Utility

Map

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 424

Chapter

13.

Filter

Utility

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 433

CXXFILT

options

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 434

SYMMAP

|

NOSYMMAP

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 434

SIDEBYSIDE

|

NOSIDEBYSIDE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 434

WIDTH(width)

|

NOWIDTH

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 434

REGULARNAME

|

NOREGULARNAME

.

.

.

.

.

.

.

.

.

.

.

.

.

. 434

CLASSNAME

|

NOCLASSNAME

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 435

SPECIALNAME

|

NOSPECIALNAME

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 435

Unknown

type

of

name

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 435

Under

z/OS

batch

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 435

Under

TSO

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 436

Chapter

14.

DSECT

Conversion

Utility

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 439

DSECT

Utility

options

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 439

Contents

ix

SECT

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 439

BITF0XL

|

NOBITF0XL

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 440

COMMENT

|

NOCOMMENT

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 441

DECIMAL

|

NODECIMAL

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 441

DEFSUB

|

NODEFSUB

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 442

EQUATE

|

NOEQUATE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 443

HDRSKIP

|

NOHDRSKIP

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 445

INDENT

|

NOINDENT

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 445

LOCALE

|

NOLOCALE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 445

LOWERCASE

|

NOLOWERCASE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 446

LP64

|

NOLP64

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 446

OPTFILE

|

NOOPTFILE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 446

PPCOND

|

NOPPCOND

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 446

SEQUENCE

|

NOSEQUENCE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 447

UNIQUE

|

NOUNIQUE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 447

UNNAMED

|

NOUNNAMED

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 448

OUTPUT

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 448

RECFM

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 448

LRECL

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 448

BLKSIZE

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 448

Generation

of

structures

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 448

Under

z/OS

batch

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 451

Under

TSO

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 452

Chapter

15.

Coded

Character

Set

and

Locale

Utilities

.

.

.

.

.

.

.

.

. 453

Coded

Character

Set

Conversion

Utilities

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 453

iconv

Utility

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 453

genxlt

Utility

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 455

localedef

Utility

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 457

Part

5.

z/OS

UNIX

System

Services

utilities

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 463

Chapter

16.

Archive

and

Make

Utilities

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 465

Archive

libraries

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 465

Creating

archive

libraries

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 465

Creating

makefiles

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 466

Makedepend

Utility

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 466

Chapter

17.

BPXBATCH

Utility

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 467

BPXBATCH

usage

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 467

Parameter

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 468

Usage

notes

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 469

Files

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 469

Chapter

18.

c89

—

Compiler

invocation

using

host

environment

variables

471

Format

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 471

Description

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 471

Options

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 473

Operands

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 483

Environment

variables

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 486

Files

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 504

Usage

notes

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 505

Localization

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 511

Exit

values

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 511

Portability

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 511

Related

information

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 512

x

z/OS

V1R6.0

C/C++

User’s

Guide

||

Chapter

19.

xlc

—

Compiler

invocation

using

a

customizable

configuration

file

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 513

Format

.

.

.

.

.