Table of Contents

Introduction

Documentation Updates

What's New?

BARS (Activity Reporting System)

BARS Commands

BYE Command

CYCLE Command

DISPLAY Command

HELP Command

LOAD Command

NEWDISPLAY Command

PACK Command

PERIOD Command

SAVE Command

WORDS Command

Keywords

MONITOR File Format

MONITOR Record 1 (Operational Information)

MONITOR Record 2 (Utilization Times and Counts Information)

MONITOR Record 3 (Queue Information)

BUILDX Utility

Running the BUILDX Utility

Files Used by the BUILDX Utility

CARDLINE Utility

Printing a Data Deck

Examples

CDFORMAT

Creating Media

Limitations

Examples

Hardware Requirements

COMPARE Utility

Running the COMPARE Utility

Using MARC to Run COMPARE

Using a WFL Job to Run COMPARE

Files Used by the COMPARE Utility

Output from the COMPARE Utility

DCSTATUS

Execution

CANDE DCSTATUS Command

CANDE and WFL Run Statements

DCSTATUS Options

DUMPALL Utility

Understanding Key DUMPALL Concepts

Using DUMPALL Commands

Use of Long File Names

Understanding File Records

Understanding Structural File Attributes

Specifying Data or Character Set Translations

Special Considerations for Using BNA Logical I/O Host Services

Standard Commands

ATTRIBUTES or FILE Command

CAT Command

COPY Command

DEFINE Command

DMPMT Command

HEXDSK Command

LIBMT Command

LIST Command

TEST Command

Interactive List Routine Commands

Interactive AGAIN Command

Interactive FILE or ATTRIBUTES Command

Interactive CONTINUE Command

Interactive LIST Command

Interactive MODE Command

Interactive NEXT Command

Interactive OPEN Command

Interactive PREVIOUS Command

Interactive PRINT Command

Interactive QUIT Command

Interactive RECORD Command

Interactive SKIP Command

Running the DUMPALL Utility

Parameter Mode

Interactive Mode

Using the MARC Interface

Controlling I/O Exceptions

Input to the DUMPALL Utility

Basic DUMPALL Constructs

Field Definition

Format Definition

Key Option

Old Specs

Print Option

Record Range List

Skip Specification

Handling Tape Files

Description of Tape Formats

Output Files

Input Files from Labeled Tapes

Input Files from Unlabeled Tapes

Treating Labeled Tapes as Unlabeled Tapes

DUMPANALYZER

General Information

DUMPANALYZER Files

Family Substitution

Saved Memory Dumps

Analysis of Memory Resident Information

Compatibility of MCP, DUMPANALYZER and SDASUPPORT Levels

Sensitive Memory Area Dumps

Running DUMPANALYZER

Remote Operation

ODT Operation

Batch Operation

User Library Interface for DUMPANALYZER

Entry Points for the User Library Interface

Analyzing Program Dumps

Basic Constructs

Number

File Title

Simple Address

Multiple Addresses

Simple Value

DUMPANALYZER Commands

AREAS (Memory Areas)

ARRAYLIMIT (Array Limit)

ASD (Actual Segment Descriptor)

ASDNUMBER (Actual Segment Descriptor Number)

BOXINFO (Box Information Array)

BYE (Stop DUMPANALYZER)

CB (Connection Block)

CODEFILE (Code File or Disk Family Name)

COREMAP (Memory Analysis)

CTRACE (Controller Trace Table Analysis)

CU (Core Utilization)

DC (Data Communications)

DCTRACE (Data Comm Trace)

DEADLOCK (Lock Analysis)

DEBUG (Debug Option)

DESCANAL (Descriptor Analysis)

DISKFILE (Disk Output File)

FIB (File Information Block)

FILELOCKS (File Region Locks)

FINDSTACKS (Find Stacks)

GC (Group Configuration)

GRAPHS (Graph Stacks)

HARDINFO (Hardware Information)

HDR (Disk File Header)

HEADING (Heading Page)

HEAP (Heap Analysis)

HEAPSTACK (Heap Stack Analysis)

HELP (Help Information)

HISTORY (History Command)

IO (I/O Analysis)

IOCB (I/O Control Block)

IOCD (Direct I/O Control Block)

IOTRACE (I/O Trace Table)

JOB (Job Command)

KEEP (Keep Command)

LIB (Library)

LINKCHECK (Check Memory Link)

LINKS (Memory Links)

LOADXREF (Load Cross-Reference Files)

LOCKS (Lock Analysis)

LOGRECORD (Log Record Analysis)

LSN (Analyze Datacom Station)

MASK (Mask Register)

MAXPRINTSIZE (MAXPRINT)

MD (Memory Dump)

MEM (Memory)

MEMPOOL (Analyze Memory Pool)

MEMRQ (Memory Result Queue)

MESSAGES (Data Comm Messages)

MIT (Mirror Information Table)

MIX (Mix Number)

MODE (Set Mode)

MSCW (Mark Stack Control Word)

NAMES (MCP Names and Addresses)

NSP (Network Support Processor Tables)

OLAYINFO (Overlay File Allocation)

OPT (Option)

PATTERN (Pattern Register)

PC or PRINTCODE (Print Mnemonic)

PIB (Process Information Block)

PMQ (Primitive Message Queue)

POOL (Analyze Pool Area)

PORT (Port File)

PRIMITIVEDUMP (Primitive Dump Analysis)

PRINTARRAY (Print Array)

PRINTER (Printer Route)

PRINTHEAP (Print Heap)

PROCSTACKS (Processor Stacks)

PROGRAMDUMP (Program Dump)

PV or PRINTVAL (Print Value)

QUEUE (DCALGOL Queue)

RCWTOSEQ (Convert RCW Into Sequence Number)

READYQ (Ready Queue)

RECESS (Recess DUMPANALYZER)

RELEASE (Release File)

RELX (Release Now)

REMOTE (Remote Terminal)

REPEAT (Repeat Command)

RESULTQ (Result Queue)

SAVE (Save to Disk)

SB (Structure Block)

SCRUB (Scrub Sensitive Memory Areas)

SEARCH (Search for Pattern)

SF (System Factors)

SFV (System File Vector)

SHAREDBUFF (Shared Buffers)

SHOW (Show Previous Input)

SSAQ (Storesafe Alert Queue)

STACK (Format Stack Contents)

STACKWINDOW (Stack Window)

STOP (Stop DUMPANALYZER)

SUBPORT (Subport Analysis)

SUMMARY (Summarize Stack Information)

TAB (Task Attribute Block)

TCPINFO (Task Control Processor Information—IOM Systems)

TERMINAL (Terminal Characteristics)

TRACE (Trace Table)

USE (Use Saved Commands)

USERCOMMAND Command

USERLIB (User Library Command)

UTILIZATION (System Utilization Statistics)

WHERE (Show Global Identifier)

WHO (Show D[0] Global Identifier)

@ (Last Referenced Stack)

$ (Last Referenced Segment)

?AX BRK (Interactive Break)

Error Messages

EMAIL Utility

Function

Options

Installing the EMAIL Utility

Considerations for File Attachments

Running the EMAIL Utility

Examples

Errors and Warnings

Retry Mechanism

FILECOPY Utility

Processing FILECOPY Requests

Constraints

Input to the FILECOPY Utility

Basic FILECOPY Constructs

FILECOPY Task Requests

CREATED, ACCESSED, UPDATED, and ANYUPDATED Requests

ADDED and ALLFILES Requests

EXPIRED Request

FILECOPY Modifiers

FILECOPY Options

Splitting WFL COPY Statements

WFL Failures

Index Files

Sample FILECOPY Runs

FILEDATA Utility

Running the FILEDATA Utility

Input Options

Output Options

Selecting the Files to Be Reported On

Running FILEDATA with a Privileged Usercode or from an ODT

Running FILEDATA with a Nonprivileged Usercode

Running FILEDATA with a Request to Access Headers from a Library Maintenance Tape

Running FILEDATA with a Request to Access Headers from a Container

Effects of Family Substitution

Error Reporting

Database Generation and Reuse

General Behavior

Reuse for Particular Reports

Database Version Levels

Database Examples

Sample FILEDATA Runs

WFL Jobs

CANDE Commands

Task Requests

ALGOLCHECK Request

ARCHIVEINFO Request

AREASUMMARY Request

ATTRIBUTES Request

BACKUP Request

CATALOGINFO Request

CHECKERBOARD Request

CODEFILEINFO Request

COMPATIBILITY Request

COPYDECK Request

DEFINEOUTPUT Request

FILENAMES Request

HEADERCONTENTS Request

INCOMPATIBILITY Request

NAMELIST Request

NOREPORTS Request

STRUCTUREMAP Request

TAPEDIR Request

FILEDATA Modifiers

ABBREVIATED

ALL

ALTERDATE

APL

ARCHIVE

ARCHIVEBACKUP

AREALENGTH

AREAS

AREASINUSE

AREASIZE

ATTMODIFYDATE

BACKUPDATE

BACKUPSN

BADINFO

BLOCKSIZE

BLOCKSTRUCTURE

CATALOGUE

CCSVERSION

CLEARAREAS

CODEINFO

CODEVERSION

CONTAINER

COPYDESTDATE

COPYSOURCEDATE

CREATIONDATE

CRUNCHED

CYCLE

DATABASE

DELETED

DECK

DIRECTORY

DMAUDITFILE

EXECUTEDATE

EXTDELIMITER

EXTMODE

FAMILYNAME

FILECLASS

FILEKIND

FILELENGTH

FILENAME

FILEORGANIZATION

FILESERIALNO

FILESTRUCTURE

FILETYPE

FRAMESIZE

GUARDFILE

IDENTITY

INTMODE

INUSE

LASTACCESSDATE

LASTRECORD

LEVEL

LIBMAINTDIR

LICENSEKEY

LINEWIDTH

LOCKEDFILE

MAXRECSIZE

MINRECSIZE

NAMESONLY

NEWDATABASE

NONRESIDENTONLY

NOTE

OPENDATE

PACKNAME

PAGESIZE

PPB

PRINTER

PRODUCT

PROTECTION

RAWHEADERS

READDATE

RELEASEID

REMOVED

RESIDENTONLY

SAVEFACTOR

SCREEN

SECURITY

SERVICES

SPO

TAPE

TAPEHEADERS

TIMESTAMP

TITLE

TOTALSECTORS

TTY

UNITS

USERINFO

VERSION

WARNINGS

WORKLOADGROUP

WRAPPEDFILES

Numeric Report Requests

Using System Commands to Initiate FILEDATA

DIR (Directory) Command

TDIR (Tape Directory) Command

Basic FILEDATA Constructs

GUARDFILE Utility

Operational Information for GUARDFILE

Creating a Working Guard File

Listing the Contents of an Existing Guard File

Attaching Guard Files

Reference Information for the GUARDFILE Utility

Value and Station Attributes

Input File Equation Specifications

Output File Equation Specifications

GUARDFILE Source Input

Examples for Defining Access Rights

GUARDFILE Input and Output Example for a Database

Input

Output

HARDCOPY and PRINTCOPY

HARDCOPY

Running HARDCOPY

Disk File Format

PRINTCOPY

Running PRINTCOPY

INTERACTIVEXREF Utility

INTERACTIVEXREF Operation

Files Used by the INTERACTIVEXREF Utility

Running the INTERACTIVEXREF Utility

Input to the INTERACTIVEXREF Utility

Basic INTERACTIVEXREF Constructs

INTERACTIVEXREF Commands

DECLARATIONS Command

EXPAND Command

HELP Command

LIST Command

LOAD Command

LOCATE Command

MERGE and COINCIDENCE Commands

QUALIFY Command

RANGE Command

REFERENCE Command

SAVE Command

SET and RESET Commands

STOP Command

SUMMARY Command

SYMBOL Command

TERMINAL Command

TEXT Command

WHAT Command

WHATFILES Command

WHERE Command

Using the INTERACTIVEXREF Utility

Use with Improperly Sequenced Source

Use with COBOL74 AND COBOL85

Use with C

Use with FORTRAN77

Use with PASCAL and PASCAL83

Example INTERACTIVEXREF Program

INVENTORY Utility

Using the INVENTORY Utility

Report File Destination

Saving the Report to Another File Title or Family

Security Administrator Status

Report Format

Example Report

Scheduling a Periodic Run of the INVENTORY Utility

Limitations

Viewing the Report

Comparing the Report

KEYEDIO Support

Physical Structure of KEYEDIO Files

Coarse Tables

Fine Tables

Data Blocks

Locating Data

File and KEYEDIO Library Management

Removing and Installing a KEYEDIO Library

KEYEDIO Program Interface

Indexed KEYEDIO File Attributes

Setting the FILEORGANIZATION Attribute

Setting the EXCLUSIVE Attribute

Setting the Value of the BUFFERS Attribute

Choosing a Value for the BLOCKSIZE Attribute

KEYEDIO Procedures

Key Information

File Access Information

Results Returned

ISMGETKEYSTRUCTURE Procedure

ISMOPEN Procedure

ISMCLOSE Procedure

ISMSTART Procedure

ISMSEQUENTIALWRITE Procedure

ISMSEQUENTIALREAD Procedure

ISMRANDOMWRITE Procedure

ISMRANDOMREAD Procedure

ISMREWRITE Procedure

ISMDELETE Procedure

ISMSETUPLIMIT Procedure

The KEYEDIO File Structure

Segment 0 (Zero) of the File

Block Information Layout

Coarse Table Layout

Fine Table Layout

Key Information Table Layout

Logical Layout of a KEYEDIO File

Inserting Keys

Recovery Procedures

LOGANALYZER

Installing Related Libraries

Analyzing Logs from Different Releases

Merging Entries from the SUMLOG and SECURITYLOG

Finding Missing Log Entries

Running LOGANALYZER

Interactive LOGANALYZER Commands

QUIT Command

NEXT+ Command

NEXT- Command

PAGE Command

NEXT LOG Command

Option List

LOGANALYZER Options

Selection Options

Output Options

Input Examples

LOGANALYZER Output

LOGGER

LOGGER Operation

LOGGER Input

Input-Specification Commands

Report-Specification Commands

Report-Specification Command Examples

File Data Items

Long-Term Report Generation

Extended Time Period Reports

Year-to-Date Totals Reports

Program Operation Characteristics

REPORT Commands and LOGREPORTS File

Calculation of Charges

Corrections

Files and File Equation

$NODUMP Compile-Time Option

Program Information

Overall Organization

Structure of Program Files

Tables Used by the EDITOR Procedure

Files Used by the Program

MAKECREDENTIALS Utility

Using the MAKECREDENTIALS Utility

Examples

Errors

MAKEUSER Utility

Who Can Run MAKEUSER?

Running MAKEUSER

Running MAKEUSER in Interactive Mode

Running MAKEUSER In Batch Mode

MAKEUSER Statements

Running MAKEUSER Securely

Installing a Previous Version of the USERDATAFILE

Basic MAKEUSER Constructs

Assigning Attribute Values in a Standard USERDATAFILE

Changing the Values of Standard Usercode Attributes

Modifying Nonprivileged Usercode Attributes

Identifying Users from Remote Hosts

Using Local-Alias Usercodes

Automatic Log-On Service

Managing Usercodes for Remote Users

REMOTEUSER Statement

Functional Considerations

Identifying Kerberos Users

Data for MAKEUSER

User Segments

USER Heading

MU Heading

USER Data Specifications

Privilege Segments

Define Definitions

DEFINE

DEFAULT

DEFAULTDEFINES File

Control Statements

When the USERDATAFILE Cannot Be Changed

Disposition Construct

Increasing the AREASIZE of the USERDATAFILE

ACCESS

CREATE

COPY

RECALL

END, QUIT, or BYE

Session Control Options

SET and RESET Statements

Error Control Options

IGNORE

SYNTAX

Input Control Options

ADD

CASESENSITIVEPW

INPUT

OLDRU

Output Control Options

DEBUG

ERRDUMP

HARDCOPY

LIST

LISTI

PAGE

SAVE

SAVEINPUT

Control Option ? (Inquiry)

MAKEUSER Input and Output

Break During Output

Output Conventions

Input and Output Files

Mathematical Functions

Single-Precision Functions

ARCCOS Function

ARCSIN Function

ARCTAN Function

ARCTAN2 Function

COS Function

COSH Function

COTAN Function

ERF Function

ERFC Function

EXP Function

Single-Precision Exponentiation

GAMMA Function

LN Function

LNGAMMA Function

LOG Function

RANDOM Function

SIN Function

SINH Function

SQRT Function

TAN Function

TANH Function

Double-Precision Functions

DARCCOS Function

DARCSIN Function

DARCTAN Function

DARCTAN2 Function

DCOS Function

DCOSH Function

DERF Function

DERFC Function

DEXP Function

DGAMMA Function

DLGAMMA Function

DLN Function

DLOG Function

DSIN Function

DSINH Function

DSQRT Function

DTAN Function

DTANH Function

Double Precision Exponentiation

Complex Functions

Definitions Used in Complex Function Descriptions

CABS Function

CCOS Function

CEXP Function

CLN Function

CSIN Function

CSQRT Function

Complex Exponentiation

Common Constants

Permissible Argument Ranges

MCP TapeStack Utility

Packaging Information

Initiating the MCP TapeStack Utility

STACK Function

UNSTACK Function

APPEND Function

ENCRYPT Function

DECRYPT Function

ENCRYPT&STACK Function

ENCRYPT&APPEND Function

UNSTACK&DECRYPT Function

CONSOLIDATE Function

DUPLICATE Function

INVALIDATE Function

DIRECTORY Function

SIZE Function

RECREATEDIRECTORY Function

SETTINGS Function

HELP Function

PATCH Utility

Running the PATCH Utility

Using a WFL Job to Run the PATCH Utility

Using CANDE to Run the PATCH Utility

Files Used by the PATCH Utility

Patch Control Records

Patch Compiler Control Records ($ Records)

Patch Literal Compiler Records ($& Records)

Patch Delimiter Records ($# Records)

Patch Comment Records ($: Records)

Patch Patch Records ($- Records)

Patch WFL Records ($* Records)

Patch Control Records ($. Records)

Patch Control Record Options

$.BRIEF Option

$.COBOL Option

$.COBOL74 Option

$.COBOL85 Option

$.COMPARE Option

$.COMPILE Option

$.CONFLICT Option

$.COUNT Option

$.CYCLE Option

$.DELETE Option

$.DELIMOPT Option

$.DISK Option

$.DISK $ Option

$.DUMP Option

$.EOF Option

$.ERRLIST Option

$.EXECUTE Option

$.FILE, $.DISK $, and $.PATCHDECK Options

$.FLAG Option

$.GUARD Option

$.INSERT Option

$.JOB Option

$.LABEL Option

$.LIST Option

$.LISTD Option

$.LISTI Option

$.LISTN Option

$.LISTP Option

$.MARK Option

$.MARKBLANK Option

$.MOVE Option

$.NDLII Option

$.NEW Option

$.OUT Option

$.PASCAL Option

$.PATCHDECK Option

$.RETAIN Option

$.RPG Option

$.SINGLE Option

$.SQUASH Option

$.TOTAL Option

$.VERSION and $.CYCLE Options

$.WIDE Option

$.WIDECARD Option

Debug $. Records

Debug Options

Examples of PATCH Utility Input

PCDRIVER Utility

Running the PCDRIVER Utility

Error Messages

LAUNCHER

LAUNCHER on Windows

Internationalization Issues

PDIR, PMIX, and PUNIT Utilities

Common Constructs

Running the Utilities

Using WFL

Using CANDE or MARC

Using System Commands

PDIR Utility

PMIX Utility

PUNIT Utility

RLTABLEGEN Utility

General Information

Installation Defined Tape Labels

Running the RLTABLEGEN Utility

Input to the RLTABLEGEN Utility

Label Description Format

RLTABLEGEN Commands

RUNX Utility

Running the RUNX Utility

Files Used by the RUNX Utility

SORT Utility

SORT Parameters

Input Options

Output Options

Compare Procedure

Number of Tapes

Record Size

Memory Size

Disk Size

SORT Operating Modes

Disk-Only Mode

Tape-Only Mode

ITD Mode

Memory-Only Mode

SORT Files

Control Files

Work Files

Tape Files

Tag Sorting

Restart Capability

RESTART Parameter Values

Restarting during Stringing Phase

Error Recovery

Control File Input Errors

Control File Output Errors

Work File Input Errors

Work File Output Errors

User Output File Errors

Work File Input Errors during User Output

Using SORT in Various Languages

Using SORT in COBOL74 or COBOL85

Using SORT in ALGOL

Using SORT in C

Using SORT in FORTRAN77

Using a Procedural Interface for SORT

SORT Error Messages

SORT Statistical Array

SSH Utility

Using the SSH Client

User Authentication

SSH Client Output

Getting Started

Creating a WFL Job to Execute an SSH Command

SSH Client Application Program Interface (API)

Running the SSHCLIENTSUPPORT Library

Installing a New Version of SSHCLIENT Software

Automatically Restarting SSHCLIENTSUPPORT Following a Halt/Load

Terminating the SSHCLIENTSUPPORT Library

Non-Diagnostic Logging Supported by SSHCLIENT

Diagnostic Log Levels Supported by SSHCLIENT

Details of the SSH Client Configuration File

Removing *SYSTEM/SSHCLIENT/REQUEST files

UTILX Utility

Running the UTILX Utility

Files Used by the UTILX Utility

V Series Conversion Utilities

COPYV2A Utility

Command Interface

Screen Interface

PRINTV2A Utility

Label Equation Interface

Screen Interface

PRINTA2V Utility

Label Equation Interface

Screen Interface

XREFANALYZER Utility

XREFANALYZER Files

Invoking XREFANALYZER

Implicit Execution

Explicit Execution

Compile Time Options

Fatal Error Messages

GENERALSUPPORT Entry Points

CHANGELFILE

REMOVELFILE

MYOPTIONSUPPORT

Understanding Railroad Diagrams

Railroad Diagram Concepts

Paths

Constants and Variables

Constraints

Following the Paths of a Railroad Diagram

Railroad Diagram Examples with Sample Input