FDM Command Reference
FDM Command Reference
Command Reference
Serena Proprietary and Confidential Information
Copyright
Copyright © 2001-2011 Serena Software, Inc. All rights reserved.
This document, as well as the software described in it, is furnished under license and may
be used or copied only in accordance with the terms of such license. Except as permitted
by such license, no part of this publication may be reproduced, photocopied, stored in a
retrieval system, or transmitted, in any form or by any means, electronic, mechanical,
recording, or otherwise, without the prior written permission of Serena. Any reproduction
of such software product user documentation, regardless of whether the documentation
is reproduced in whole or in part, must be accompanied by this copyright statement in its
entirety, without modification.
This document contains proprietary and confidential information, and no reproduction or
dissemination of any information contained herein is allowed without the express
permission of Serena Software.
The content of this document is furnished for informational use only, is subject to change
without notice, and should not be construed as a commitment by Serena. Serena
assumes no responsibility or liability for any errors or inaccuracies that may appear in this
document.
Trademarks
Serena, TeamTrack, StarTool, PVCS, Collage, Comparex, and ChangeMan are registered
trademarks of Serena Software, Inc. The Serena logo, Dimensions, RTM, Professional,
Version Manager, Builder, Meritage, Change Governance, Profit From Change, Command
Center, Composer, Reviewer, and Mover are trademarks of Serena Software, Inc.
All other products or company names are used for identification purposes only, and may
be trademarks of their respective owners.
Chapter 3 Commands — A to C . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Subcommands and Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
ABE Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
ACFCOMP Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Command Reference 3
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
ALIAS Subcommand. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
ATTRIB Subcommand (for source members) . . . . . . . . . . . . . . . . . . . . . 57
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Operands — source members . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Remarks — Source Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
ATTRIB Subcommand (for load members) . . . . . . . . . . . . . . . . . . . . . . 60
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Operands — Load Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Remarks — Load Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
BLK3380 Subcommand. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
BLK3390 Subcommand. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
BLK9345 Subcommand. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Command Reference 5
COMPARE Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
COMPDIR Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
COMPRESS Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
CONDEND Subcommand. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
CONTROL Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
COPY Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Abbreviations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Command Reference 7
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
DELINK Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
DIRENTRY Subcommand. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
DISASM Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
DISPLAY Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
DSAT Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
DSNAME Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
DUP Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Command Reference 9
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
EXEC Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Command Reference 11
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
ISPF Subcommand. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
ISPMODE Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
ISPXEQ Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Command Reference 13
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
MASK Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
MEMBERS Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
MEMLIST Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
MEMLIST and Deleted Members. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
NUCMAP Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Command Reference 15
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
PROFMAN Function. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
QUIT Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
READOBJ Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
RECALL Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
RENAME Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
REPLACE Subcommand. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
Abbreviations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
Command Reference 17
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
SUBMIT Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
STATUS Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
SVCMAP Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
TSO Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
TSOEDIT Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
TSOLIST Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Command Reference 19
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
WHOHAS Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
WORKPAD Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
XREF Subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
ZAP Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
Remarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
Command Reference 21
22 Serena® StarTool® FDM 7.7.1
Welcome To StarTool FDM
The separately licensed StarBat Option, DB2 Option, IMS Option, and Extended Compare
Option are described elsewhere.
StarTool FDM StarTool FDM is a multi-purpose file and data management utility for IBM mainframe
systems. It provides an ISPF-based, menu-driven, integrated interface to a variety of file
editors and data management tools for PDS, PDSE, VSAM, direct-access, IMS, and DB2
files. A TSO command-line interface is supported concurrently, and bulk file updates in
batch mode are also supported. Separately licensed product options allow users to
purchase only the capabilities they need.
Audience The intended audience for this document is IBM mainframe systems programmers and
application specialists who are already familiar with StarTool FDM commands and want a
reference organized by name for look-up of command syntax and function details.
Corrections The Readme file on the product media contains updates and corrections to this manual
and Technical issued after the publication date. It also provides contact information for Serena
Support Customer Support.
Conventions
Terminology Throughout this document:
z/OS refers to the z/OS™ and OS/390® IBM® operating systems.
StarTool FDM may also be referenced as StarTool or FDM.
Command Reference 23
Welcome To StarTool FDM
somnode is the high-level qualifier you specify for StarTool FDM installation libraries.
vrm is the version, release, and modification level of StarTool FDM without
punctuation; for example, for StarTool FDM Version7.7.1, the value of vrm is 770.
Typographic The following textual conventions are used throughout this document to highlight special
Conventions information:
Convention Meaning
Bold Panel title or field name.
Italics Introduces new terms, sets off important information, or
marks document titles.
UPPERCASE Indicates keys or key combinations; for example, the
ENTER key.
Bright blue Clickable cross-reference or active hyperlink.
Monospaced JCL, source code, or message text. Also used for member
names, file names, and commands if these are not clear
from context.
MONOSPACED Required value or literal in code or JCL parameter.
UPPERCASE
monospaced Pattern for a field value or parameter you specify. Number
lowercase of characters is significant. Upper-case characters are
literals. Lower-case characters are placeholders that
indicate data type, where:
y = year
m = month
d = day
a = alphanumeric
n = numeric
x = other or mixed
? = one-character wild card
* = n-character wild card
Punctuation other than wild cards must be reproduced in
the position shown.
Examples: Examples:
yyyy/mm/dd International calendar date with four-character year, two-
character month, and two-character day separated by
required slashes, such as 2010/01/01.
Alphanumeric character string in user-readable form, two
C’aa’ characters long, such as C’K9’
Binary number, two digits long, where n = 0 to 1, such
as B’10’
B’nn’
Decimal number, two digits long, where n = 0 to 9, such
as D’10’
D’nn’
Hexadecimal number, two digits long, where n = 0 to F,
such as X’C1’
X’nn’
monospaced Descriptive placeholder for value or parameter you specify,
italics but not a pattern; for example, filename.
Square braces [ ] Optional parameter or choice of values. May be nested.
Convention Meaning
Vertical bar | Inside braces, a vertical bar separates mutually exclusive
parameter choices or values.
Ellipsis ... Optional repetitions of a pattern in a list.
Greater-than symbol > Separates items in a chain of menu or command selections
on a GUI client. For example, Start > All Programs >
Serena > product_name.
Documentation
A complete set of electronic product documentation for StarTool FDM is available on the
product distribution media. You can also download the complete documentation suite from
the Serena Customer Support Web site at http://www.serena.com/support/.
Printed installation guides and Quick Reference documents are shipped with the physical
product media.
Related Publications
Available StarTool FDM publications include:
Title Description
Serena StarTool FDM System requirements, installation instructions, and
Installation Guide configuration information for StarTool FDM.
Serena SER10TY Installation information for SER10TY licensing software and
User’s Guide instructions on how to apply license key SERtificates.
Serena StarTool FDM Overview of StarTool FDM commands, with syntax details for
Quick Reference frequently used functions. Includes PEDIT and StarBat
subcommands.
Serena StarTool FDM StarTool FDM concepts and facilities, with instructions for
User’s Guide using the ISPF-based menu-driven interface.
Serena StarTool FDM TSO command-line syntax and parameter reference,
Command Reference organized alphabetically. Interactive subcommands included
for major functions.
Serena StarTool FDM Advanced reference to operating system calls used by
System Services StarTool FDM.
Serena StarTool FDM Batch-mode interface for bulk changes to data sets.
StarTool FDM StarBat StarTool FDM functions invoked by JCL procedures.
Option
Serena StarTool FDM StarTool FDM data management functions for DB2 relational
DB2 Option database tables, columns, and rows, with SQL processing
support.
Serena StarTool FDM StarTool FDM data management functions for IMS
IMS Option hierarchical database files and structures.
Command Reference 25
Welcome To StarTool FDM
Title Description
Serena StarTool FDM Integrated file comparison utility based on Serena
Extended Compare Comparex. Data file versus text file comparison logic.
Option
Serena StarTool FDM Consolidated message reference for base product and all
Messages licensed product options, with error recovery
recommendations.
The PC client installer unloads the full document set from the binary product files to the
location you designate on your client PC during installation. The Readme file is an HTML
document that displays in your Web browser. All other documentation is provided in
Adobe’s Portable Document Format (PDF).
TIP Be sure to download the full version of Reader. The more basic version does not
include the cross-document search feature.
This section highlights some of the main Reader features. For more detailed information,
see the Adobe Reader online help system.
To search across multiple PDF documents at once, perform the following steps (requires
Adobe Reader Version 6 or higher):
2 In the text box, enter the word or phrase for which you want to search.
3 Select the All PDF Documents in option, and browse to select the folder in which
you want to search. (If you have a document open that has an Adobe Catalog index
attached, you can leave the In the index named... option selected to search across
all the manuals in the index.)
4 Optionally, select one or more of the additional search options, such as Whole words
only and Case-Sensitive.
NOTE Optionally, you can click the Use Advanced Search Options link near the
lower right corner of the application window to enable additional, more powerful
search options. (If this link says Use Basic Search Options instead, the advanced
options are already enabled.) For details, see Adobe Reader's online help.
Command Reference 27
Welcome To StarTool FDM
Examples
STARTOOL lib.cntl
TSO STARTOOL lib.cntl
Syntax
STARTOOL
{dsn [VOLUME(vser)/VOLSET(vdef)][SHR/OLD]|
*|
FILE(ddname) [NUMBER(num)]}
[ISPMODE|XISPMODE|ISPXEQ command|subcommand|MEMLIST memgroup]
Aliases
PDS, PDSE
Defaults
ISPMODE if in an ISPF session, otherwise XISPMODE; SHR
Required
dsn or FILE(ddname)
Operands
dsn Identifies the data set name. If you fail to enter the data set
name in quotes (‘), your TSO PREFIX is appended to the start
of the entered data set name. If you enter * in this position,
the system assumes FILE(ISPPROF). If this is a migrated data
set, StarTool FDM changes to your ISPF profile data set to avoid
startup delays. If your system has password security, enter
your data set password after the data set name and a slash /.
The syntax is dsn/password.
Command Reference 29
Chapter 1 TSO Command Summary
VOLUME(vser) Specifies the volume name on which the data set resides. If
you enter a volume name, SYSALLDA is assumed as the unit
name; otherwise, StarTool FDM uses the unit name from the
catalog. Use this parameter if the data set is not cataloged or if
the catalog entry is not to be used. To use the catalog for the
STARTOOL command, even if VOLSET is in effect, enter
VOLUME(*).
VOLSET(vdef) Specifies a default volume name for data set references. If you
enter VOLSET(NEWRES), subsequent CHANGE subcommands
with a data set name and no VOLUME parameter assume
VOLUME(NEWRES). Use this parameter if you want a default
volume. To nullify the effect of VOLSET, enter VOLSET(*) on a
subsequent CHANGE subcommand.
SHR Allocate the data set with a disposition of SHR (share). Allow
simultaneous use of this data set by others.
OLD Allocate the data set with a disposition of OLD. Do not allow
simultaneous use of this data set by others. The use of SHR is
recommended.
FILE(ddname) Identifies the DDNAME of a pre-allocated data set. Only disk
data sets (including VIO) are supported. If you use the FILE
keyword, then do not use dsn, SHR/OLD, VOLSET, and
VOLUME. If the data set is concatenated, the data set is
reallocated so you can use SHR or OLD.
NUMBER(num) Specifies the concatenation number for the DDNAME allocation
for the FILE keyword. num defaults to 1 but if num is larger
than the number of concatenated data sets, the last data set in
the sequence is used.
ISPMODE Requests that StarTool FDM initialize in ISPMODE. This is the
initial mode only; you can suspend ISPMODE and MEMLIST
with a later subcommand.
XISPMODE Requests that StarTool FDM initialize in line mode (independent
of ISPF). This is the initial mode only; at a later time, you can
enter an ISPMODE or MEMLIST subcommand.
MEMLIST memgroup Requests that StarTool FDM initialize with a member list set to
the named member group. This is the initial mode only; you
can suspend MEMLIST and ISPMODE with a later subcommand.
ISPXEQ command Requests that StarTool FDM initialize with the ISPMODE service
(usually DDNAME, LISTA, LISTC, LISTF or LISTV) named. This
is the initial mode only; you can enter other STARTOOL
subcommands after the initial display.
subcommand Requests that StarTool FDM perform the single subcommand
and terminate. This is a special subcommand mode for
performing only a single subcommand. In this mode, ISPF
services are not available and StarTool FDM operates in line
mode only. Also, there is no YES/NO prompting; instead, YES
responses are assumed.
When you invoke StarTool FDM in single subcommand mode,
the return code is set to the numeric value of the first warning
or error message encountered.
PDS200I DISP UNIT RECFM LRECL BLKSIZE ALLOCTRK FREETRK SECONDARY FREEDIR
PDS200I SHR 3390 FB 80 13680 1X 100 19 50 TRK 17
When you specify a default member name or group by one of the above subcommands,
the member name or group becomes the “current member group” or the “default member
name or group” (the ALIAS, RENAME, and RESTORE subcommands also modify the
default member group but do not process member groups). The current member group
can be referred to by this set of subcommands until it is again redefined.
Member Groups
Subcommands that allow default member names also accept member groups as member
names. A member group can be a single member name, a range of member names, a
member name pattern, or a lists of member names or other valid member group
specifications. See Appendix A, "Formatting Member Names", for more information.
1 Enter a single asterisk (*) to refer to the currently defined member group.
Command Reference 31
Chapter 1 TSO Command Summary
2 A member name range is of the form name1:name2, which selects members based on
character string ranges in their names.
3 A pattern member name is of the form name1/name2, which selects members based
on character string matches in their names.
7 Enter a single equal symbol (=) to refer to the list of members in the current
MEMLIST. If a MEMLIST is not active, the equal symbol is equivalent to an asterisk
(the current member group).
When executing a subcommand from the TSO command line, you can abbreviate
subcommand names to the first few characters. You can also abbreviate any keyword
operands for these subcommands. The general rule is that you abbreviate by dropping
ending characters of a keyword name as long as the abbreviated keyword remains unique
for the subcommand.
Command Reference 33
Chapter 1 TSO Command Summary
Command Reference 35
Chapter 1 TSO Command Summary
Command Reference 37
Chapter 1 TSO Command Summary
This section lists all interactive StarTool FDM commands in alphabetical order. Defaults are
underlined and the shortest valid abbreviation for a command name is shown before the
[brackets]. For example, a command shown as COMM[ENT] could be specified as COMM,
COMME, COMMEN, or COMMENT.
Common Commands
This section documents ISPMODE-only commands that you can enter in any ISPMODE
function. <Xref>“All Commands” documents all ISPMODE only commands that can be
entered (including commands specific to a single function).
ALIASCHK Alias check. Checks aliases and adds all associated members to
the MEMLIST display.
ALL MEMLIST all. Adds all members in the data set to the MEMLIST
display.
ALLOC[ERR] Goes to a tutorial explaining dynamic allocation error codes.
ALTC[MD] Executes a subcommand (previously saved by SETALT) on the
current data set.
ALT[ERNAT] Displays an alternate view of the current table.
APP[LY] Applies the specified line command to all table entries and
executes each entry.
Syntax APPLY linecmd
Command Reference 39
Chapter 2 ISPF Interface Commands
MODEL Provides a prompt panel (with initial data set values) for the
CREATE or IDCAMS subcommand.
MON[TH] Merges members updated or created this month into the
MEMLIST.
NOR[MAL] Displays the default view of the current table.
O[PTIONS] Provides primary command selection for the current function and
operand syntax assistance.
OUT[PUT] Outputs the current function table to print or to a data set.
Syntax OUTPUT [=c / F(ddname)]
PAN[EL] Selects a panel using ISPF display services (normally used for
panel testing).
Syntax PANEL member
PEND Checks for pending line commands and selects the next one. If no
line commands are pending, the command is ignored or the
primary MENU is selected if MENU mode is enabled.
PRIM[ER] Goes to a StarTool FDM introductory tutorial.
R[ECALL] Displays the last StarTool FDM subcommand for modification and
(or RC) rentry. RECALL also retrieves subcommands from the log.
REL[EASE] Prompts for FIXPDS operands that release excess disk space.
RF[IND] Finds a string (repeat find). In the log, it resets the display start
location and positions the cursor over the string; otherwise, it just
positions the display start location. PF keys 5 and 17 are normally
set to RFIND.
RI[GHT] Rotates through alternate views of the current data. PF keys 11
and 23 are normally set to RIGHT.
SET Prompts for one of the following SET services.
SETA[LL] Controls StarTool FDM combined defaults
SETALT Recalls and saves a subcommand for repeated use later by
ALTCMD.
SETC[OLOR] Controls screen colors and highlighting.
SETD[SN] Sets data set controls.
SETK[EYS] Controls PF keys for StarTool FDM panels (for ISPF 4.x users, the
KEYS command can be used for the same effect as SETKEYS).
SETP[ANEL] Controls optional panels and panel defaults.
SETSEEK Specifies the default member name for the SEEK line command.
SETSEL Specifies alias names for S (or SELECT) by function.
SETU[SER] Controls dynamic primary commands. Specify command names
and their actions.
SUS[PEND] Terminates ISPMODE temporarily and enters line mode
processing. Restart ISPMODE with the same log table by entering
an ISPMODE, ISPXEQ, or MEMLIST subcommand. While ISPMODE
is suspended, IND$FILE is supported for PC SEND and RECEIVE.
TAG Forms a member group containing only members marked with
*TAG* in the DATA/MSG field for MEMLIST. Otherwise, applies the
specified line command to table entries marked with *TAG* in the
DATA/MSG field and executes each entry.
TOD[AY] Merges members updated or created today into the MEMLIST.
TRANS Provides a translation service to convert a hex, decimal, or
EBCDIC character to the other forms.
Syntax TRANS 1-to-2-hex/1-to-3-decimal/char
[HEX/NUMBER/CHAR]
TRAP Interfaces with TSO commands to capture their output lines in the
log.
Syntax TRAP tsocommand [anyoperands]
Command Reference 41
Chapter 2 ISPF Interface Commands
Syntax X [ABOVE/BELOW/ALL]
All Commands
This section documents all ISPMODE-only commands that can be entered (including
commands specific to a single function).
Global commands are STARTOOL subcommands that apply to all data sets in a DDNAME/
LISTA, LISTC/LISTF or WORKPAD table. A command named GLOBAL is a general global
command. Follow GLOBAL with any STARTOOL subcommand. The subcommand is issued
against each data set in the table.
The FIND, REPLACE, COMPRESS, MODEL, SEEK and WHOHAS commands are also global
for these tables. In LISTC/LISTF tables, the FIND, REPLACE, COMPRESS and SEEK
commands skip over non-partitioned data sets. This happens because the FIND and
REPLACE subcommands use different subcommand syntax for partitioned data sets and
non-partitioned data sets. If you want to search or update non-partitioned data sets, type
GLOBAL followed by FIND or REPLACE and its operands.
The following commands are supported by StarTool FDM in ISPMODE. Several of these
commands are supported only in a single function:
ADD In WORKPAD, adds 5 blank table lines to the end of the WORKPAD
table.
In LISTV, adds data sets to the LISTF table for all volumes in the
LISTV table without prompting.
ALIASCHK Alias check. Checks aliases and adds all associated members to the
MEMLIST display.
ALL MEMLISTs all. Adds all members in the data set to the MEMLIST
display.
ALLOC[ERR] Goes to a tutorial explaining dynamic allocation error codes.
ALTC[MD] Executes a subcommand (previously saved by SETALT) on the
current data set.
ALT[ERNAT] Displays an alternate view of the current table
APP[LY] Applies the specified line command to all table entries and executes
each entry.
Syntax APPLY linecmd
BA[SE] In ZAP, resets the base address for this CSECT (like an AMASPZAP
BASE statement).
Syntax BASE hexaddress
(1 to 6 hexadecimal digits)
BAT[CHJCL] In DDNAME, LISTA, LOG and MEMLIST builds batch JCL from
information in the table.
BLK[SIZE] Provides information on disk track utilization for optimal blocking.
BOU[NDS] In PEDIT, specifies default find column limits. BOUNDS OFF and
BOUNDS with no operand turn off bounds processing. BOUNDS LIST
shows current boundaries.
Syntax BOUNDS nn mm/ OFF / LIST
BU[ILD] In ZAP, outputs AMASPZAP format output without changing the data
set. Note that AMASPZAP backout controls are also formatted as
comments.
CAN[CEL] In LOG after a reply required for RESTORE, specifies that StarTool
FDM terminate RESTORE processing. A YES response allows the
restoration of the current deleted member and a NO response skips
the current deleted member for RESTORE processing.
Otherwise, cancels pending line commands for the function
specified.
Syntax CAN CSE/CAX/LA/LF/LV/ML/W/ALL
Command Reference 43
Chapter 2 ISPF Interface Commands
CO[LS] In PBROWSE, displays a columns line on the first line of the data
area. The columns line remain at the top of the data display. It is
useful in identifying columns to be used with the FIND command.
Syntax COLS [ON/OFF]
CONT[INUE] In LOG after a checkpoint, specifies that StarTool FDM continue the
current interrupted process until the next checkpoint interval as
specified by SETALL. Use END to terminate the process.
COPYBOOK In PEDIT, prompts for a COBOL, Assembler or PL/I copybook name
to overlay define edit records. See CB for keyword details.
Syntax
COPYBOOK [ON]/[OFF]/[NEW]/[FIRST]/[NEXT]/[PREV]
CREATE In PEDIT, creates a new partitioned data set member from marked
copy or move data lines in an edit session.
Syntax CREATE [member]
F[IND] In PEDIT, finds a string and positions the display start location.
Syntax
FIND anystring [nn mm] [ASIS] [ALL]
[FIRST/LAST/PREV] [PREFIX/SUFFIX/WORD]
[CHECK] -for copybook, searches for invalid packed decimal
[NAME] -for copybook, positions to a copybook variable name
[SAME] - for copybook, searches only the current record
Command Reference 45
Chapter 2 ISPF Interface Commands
Syntax
HIDE {ALL/varnam/gennam/n1 [TO] n2} GROUP
ALL -- all variables are to be hidden
varnam -- exact variable name from the copybook
gennam -- partial variable name like FORM-DETAIL*
n1 -- entry number for a variable from SCREEN NUMBER
TO -- used with n2 to indicate a range
n2 -- a second entry number to specify a range end with TO
GROUP -- hides all variables from a given copybook level
ID In LISTC/LISTF and WORKPAD, changes the table ID name.
Syntax ID name
(where nn defaults to 5)
KEY In PEDIT, positions directly to the record with the corresponding
record key.
Syntax KEY 'record key' / x'hexkey'
LAS[TCMDS] Presents the last 32 primary commands for selection by number, for
modification and reuse.
LE[FT] Rotates through alternate views of the current data. PF keys 10 and
22 are normally set to LEFT.
LISTVT[OC] In LISTV, adds data sets to the LISTF table for all volumes in the
LISTV table after a prompt.
LO[AD] In LISTC/LISTF and WORKPAD, loads data set names from operating
system control blocks.
Syntax LOAD APFLST/LNKLST/LPALST [RESET]
MC[OPY] Interfaces with the extended copy feature using a default data set
name as set in MODEL.
M[ENU] Provides menu system command and operand entry assistance. Also
use MENU to switch between the StarTool FDM primary option panel
and the primary panels for other licensed options. Items can be
chained as in M.3.3 (or its equivalent, 3.3). In addition, entry assist
panels for most subcommands can be invoked as in M.FIND (or its
equivalent, FIND).
Syntax MENU [ON/OFF]
(1 to 6 hexadecimal digits)
OUT[PUT] Outputs the current function table to print or to a data set.
Command Reference 47
Chapter 2 ISPF Interface Commands
PAN[EL] Selects a panel using ISPF display services (normally used for panel
testing).
Syntax PANEL member
PASTE In PEDIT, places lines from the StarTool FDM clipboard into the
active edit session. Use the PEDIT or ISPF edit CUT macro to put
lines into the clipboard.
Syntax
PASTE [mm] [ZERO/KEEP] [DEFAULTS]
mm -- Two character table name
ZERO -- Insert clipboard contents and clear clipboard
KEEP -- Insert clipboard contents and keep clipboard
DEFAULTS -- Display a panel to set defaults
Example: PAD a 45
PEND Checks for pending line commands and selects the next one. If no
line commands are pending, the command is ignored or the primary
MENU is selected if MENU mode is enabled.
PREV[IOUS] For PEDIT copybook, positions to a previous logical record. Use SET
to change the default number of records to move backward if no
operands are entered. PREV 1 SET is the default. SET changes the
default and causes a new record to display.
Syntax PREVIOUS [num SET]/[MAX]
Syntax
REPLACE memgroup 'fromstring' 'tostring'
[NUM/SNUM/NONUM/LBLOCK/LDUMP/BLOCK/DUMP]
[CAPS/ASIS/IGNORE] [WORD/PREFIX/SUFFIX]
[WRITE/NOWRITE]
This table contains the copybook screen part, the header, and an example:
COBOL level and name LEVEL AND NAME 02 SAMPLE-FIRST
data type=TYPE LENGTH TYP 1 PAC
data type=PICTURE PICTURE S99V9
data type=OFFSET OFFSET 62
data type=COLUMN COLUMN 63
data type=NUMBER NUMBER 4
displayed data=DATA DATA 2.1
displayed data=NODATA OFFSET 62
SEEK Global command in LISTA/DDNAME, LISTC/LISTF and WORKPAD
changes to each data set in the table and looks for a member. In
LISTC/LISTF, non-partitioned data sets are skipped.
Syntax SEEK member
Command Reference 49
Chapter 2 ISPF Interface Commands
S[ELECT] In MEMLIST and LOG, BROWSEs load members and EDITs source
members. The value used for the command is set in SETSEL.
Syntax SELECT member
SORT In PEDIT for a VSAM KSDS data set, sorts records in ascending
order by key.
Syntax SORT
SPA[CE] In LISTV, updates volume space statistics for each volume in the
table.
STATS In LISTV, updates volume attributes for each volume in the table.
SUS[PEND] Terminates ISPMODE temporarily and enters line mode processing.
ISPMODE can be restarted with the same log table by entering an
ISPMODE, ISPXEQ or MEMLIST subcommand. While ISPMODE is
suspended, IND$FILE is supported for PC SEND and RECEIVE.
TRAP Interfaces with TSO commands to capture their output lines in the
log.
Syntax TRAP tsocommand [anyoperands]
Command Reference 51
Chapter 2 ISPF Interface Commands
Y[ES] In LOG, after a required reply, specifies that StarTool FDM continue
the current action. A NO response stops the current action. For a
RESTORE subcommand, type CAN to terminate RESTORE
processing.
ZAP In ZAP, updates data lines in *CHA (changed) status on disk
permanently.
A function command is a request for an ISPMODE operation. Most functions support their
own set of commands. Function commands control ISPF tables that are available
throughout a StarTool FDM session in parallel mode.
While operating in a StarTool FDM session, commands are ISPMODE-only requests for an
operation.
Enter subcommands, function commands and commands, as primary commands; that is,
from the top command entry line of a panel. In most function tables, enter line commands
in the CMD column. A line command is a request for an ISPMODE-only operation that
affects only the table entry on which it is entered.
In each function that supports line commands, = and X are available as line commands.
Use an = line command to repeat the previously entered line command. Use X line
commands to drop table entries selectively. Follow these line commands by a number (for
example, =3 or X3) to operate on multiple table lines.
Use block line commands to operate on multiple table entries. For example, use the XX
block line command to mark table elements to drop from a table. XX operates on a range
of entries. The first table element with an XX command is considered the first entry in the
range. All following elements are dropped up to a paired entry with another XX block line
command. XX and == block line commands are available in each function that supports
line commands.
Commands, line commands, and block line commands are documented in this section but
only under the function in which they are supported. For a discussion of all ISPMODE
commands, see “All Commands”.
ABE Subcommand
The ABE subcommand edits data; use the TSO ABE command. ABE is an acronym for A
Better Editor. Add any operand after the member name.
Example
ABE mema:memb
Command Reference 53
Chapter 3 Commands — A to C
Syntax
ABE memgroup [operands]
Aliases
AB, ABE
Defaults
None
Required
None
Operands
memgroup Default member names, member lists, member name ranges, and
member name patterns are allowed. For more information, see
Appendix A, "Formatting Member Names" on page 417.
operands Optional. Can include any TSO ABE operands.
Remarks
ABE was written in PL/I and the PL/I Optimizing Compiler Transient Library is required for
its execution.
This interface is optional. Use it only if your installation installed the public domain ABE
command.
ACFCOMP Subcommand
The ACFCOMP subcommand compiles and stores a set of CA-ACF2 access or resource
rules.
Example
ACFCOMP acfrule* nostore
Syntax
ACFCOMP memgroup [FORCE/NOFORCE ]
[LIST/NOLIST ]
[MAXRULE(nnn) ]
[STORE/NOSTORE ]
Aliases
ACF, ACFC, ACFCO, ACFCOM, ACFCOMP
Defaults
memgroup, FORCE, LIST, MAXRULE(250), STORE
Required
None
Operands
memgroup Identifies the members to be compiled.
Default member names, member lists, member name ranges
and member name patterns are allowed. For more information,
see Appendix A, "Formatting Member Names" on page 417.
FORCE Access rule sets are stored, replacing any existing access rule
sets with the same keys.
NOFORCE Access rule sets are not stored or replace any existing access
rule sets if they exist with the same keys.
LIST The rules are listed at the terminal as they are read.
NOLIST Only compiler control and error messages are listed at the
terminal.
MAXRULE(nnn) Specifies a scaling factor that determines the maximum size of
the access rule set that the buffer can hold.
STORE Access rule sets are stored automatically after compilation.
NOSTORE Access rule sets are not stored after compilation; this is a test
compilation.
Remarks
This interface is optional; use it only if your installation uses CA-ACF2 for security.
ALIAS Subcommand
The ALIAS subcommand adds an alias name for a member.
Example
ALIAS mainmem aliasmem
Command Reference 55
Chapter 3 Commands — A to C
Syntax
ALIAS memname aliasname
Aliases
AL, ALI, ALIA, ALIAS
Defaults
None
Required
memname aliasname
Operands
memname Identifies the member to which an alias is to be assigned.
aliasname Specifies the alias name to be assigned. This alias name becomes the
default member name.
Remarks
If the data set is not a load library, use the alias name as an alternate name for the
identified member.
If the data set is a load library, and if the alias name is an imbedded external name within
the load module, that external name is used as the alias entry point; otherwise, the entry
point of the named member is used as the alias entry point.
The ATTRIB subcommand can adjust the entry point of an alias or main load member with
its ENTRY(name) keyword.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
---------------- ISPMODE Session Display ----------------------- ROW 128 OF 143
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.LINK.LOAD,VOL=SER=STR804 MEM=ZAPHELP ------------------------
>------>alias zap$ zaphelp
PDS010I The alias has been assigned
PDS103I Entry point at 004418 -- ZAPHELP
>----->map
** MAP ZAPHELP
ZAP 00000000 00003F06
PCL 00003F08 000000E5
CSOUT 00003FF0 00000428
ZAPHELP 00004418 00001B1C
ASMGASM 00005F38 000007E4
OACNOW 00006720 0000032E
NOTE A StarTool FDM ALIAS created for a PDSE object containing private CSECTs will
not execute, due to invalid object code that results from a limitation of the z/OS Binder
when handling private CSECTs. This appears to be a permanent restriction of the z/OS
Binder. Message PDS898E is issued to alert you of the existence of private CSECTs in
these objects.
CAUTION! The ALIAS subcommand modifies the data set. To ensure data set integrity,
allocate the data set as OLD or be aware of the data set update protection provided by
the StarTool FDM command for SHR allocations. For details, see Appendix B, "Update
Protection".
Example
ATTRIB member1:member2 ID(userid)
Command Reference 57
Chapter 3 Commands — A to C
Syntax
ATTRIB memgroup [ALIASINFO|NOALIASINFO]
[ALIAS|NOALIAS]
[LASTREAD]
[ADDSTATS]
[ID(who)|USERID(who)]
[MOD(mm)]
[NONE]
[SSI(hexdata)|NOSSI]
[UNALIAS]
[VER(nn)]
[CREATED(yyyy/mm/dd)]
[MODIFIED(yyyy/mm/dd)]
[TIME(hhmm)]
[SIZE(nnnnn)/RESIZE]
[INIT(nnnnn)]
[MODI(nnnnn)]
Aliases
A, AT, ATT, ATTR, ATTRI
Defaults
Alias members: memgroup, ALIASINFO depending on the CONTROL setting, NOALIAS
Required
None
ID(who) Changes the last modifier’s user ID (for members with ISPF
statistics). Masking to retain current user ID characters may be
specified with a %.
USERID(who) Changes the last modifier’s user ID (for members with ISPF
statistics). Masking to retain current user ID characters can be
specified with a %.
MOD(mm) Changes the ISPF modification level (for members with ISPF
statistics).
NONE Removes ISPF statistics or SSI information.
SSI(hexdata) Adds or changes the SSI information for the member. If you enter
less than 8 hexadecimal digits, leading digits on the left are
assumed. Members with ISPF statistics cannot have SSI
information.
NOSSI Removes SSI information.
UNALIAS Converts entry to a main member.
NOTE If a main entry exists before this conversion, create an
“apparent alias”. You can detect this situation by a VERIFY
subcommand or ATTRIB with the ALIASINFO keyword.
VER(nn) Changes the ISPF version number (for members with ISPF
statistics).
CREATED Changes the ISPF creation date (for members with ISPF
(yyyy/mm/dd) statistics).
MODIFIED Changes the ISPF modification date (for members with ISPF
(yyyy/mm/dd) statistics).
TIME(hhmm) Changes the ISPF modification time (for members with ISPF
statistics).
SIZE(nnnnn) Changes the ISPF member size (for members with ISPF
statistics).
RESIZE Recalculates the member size (for members with ISPF statistics).
INIT(nnnnn) Changes the ISPF initial size (for members with ISPF statistics).
MODI(nnnnn) Changes the ISPF modified size (for members with ISPF
statistics).
NOTE This subcommand modifies the data set if you specify any attribute modifications.
To ensure data set integrity, allocate the data set as OLD or be aware of the data set
update protection provided by the StarTool FDM command for SHR allocations. See
Appendix B, "Update Protection".
Command Reference 59
Chapter 3 Commands — A to C
If the member has ISPF statistics or SSI information, this data is deleted with the NONE
keyword.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
----------------- ISPMODE Session Display ----------------------- ROW 673 OF 685
COMMAND ===> CROLL ===> CSR
- DSN=C911407.LIB.CNTL,VOL=SER=STR802 MEM=D:DEL ------------------------
>------>at d:del
PDS230I ISPF Stats: VER.MOD CREATED LAST MODIFIED SIZE INIT MOD ID
PDS230I DAFJCL 01.00 02/06/15 02/06/15 10:09 25 25 0 C91147
PDS230I DAFTAL -A 01.00 02/06/15 02/06/15 10:09 25 25 0 C91147
PDS066I Member is an alias for: DAFJCL
PDS230I DELC 01.02 02/05/10 02/05/10 15:02 19 20 2 C91147
PDS230I DELINK SSI: CB296204
PDS230I DELINK0
PDS117I 2 members counted; cumulative size is 44 records
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
----------------- ISPMODE Session# 2 Log# 1 --------------------- ROW 847 TO 861 OF 861
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.LIB.CNTL,VOL=SER=SER006 MEM=(A --- -------------
>----->attrib = modified(02/04/20)
PDS167I ATTRIB will change the following members: A, ABLK, ADOC, LOADMARK, SAMPSECR, TRIAL601
Example
ATTRIB member1:member2 RENT REUS REFR
Syntax
ATTRIB memgroup [ALIASINFO/NOALIASINFO]
[ALIAS/NOALIAS]
[LKEDDATE/NOLKEDDATE]
[SHORT]
[AMODE24/AMODE31/AMODE64/AMODEANY]
[AUTH/NOAUTH]
[DC/NODC]
[EDIT/NOEDIT]
[ENTRY(name)]
[EXEC/NOEXEC]
[LOADONLY/NOLOADONLY]
[NONE]
[PAGE/NOPAGE]
[REFR/NOREFR]
[RENT/NORENT]
[REUS/NOREUS]
[RLDFIX/NORLDFIX]
[RMODE24/RMODEANY]
[SSI(hexdata)/NOSSI]
[UNALIAS ]
Aliases
A, AT, ATT, ATTR, ATTRI
Defaults
memgroup, ALIAS, LKEDDATE (depending on the CONTROL setting), ALIASINFO (depending
on the CONTROL setting)
Required
None
Command Reference 61
Chapter 3 Commands — A to C
When the ATTRIB subcommand adds or deletes linkage attributes for a member it
performs some additional processing based on the member’s attributes and the keywords
specified.
1 If a changed member is reentrant, the reusable attribute is added (as does the
linkage editor).
Command Reference 63
Chapter 3 Commands — A to C
4 If there is a mismatch between the directory RLD/CONTROL field and the first RLD
entry of OS/VS linked modules, StarTool FDM displays an appropriate error message.
NOTE This subcommand modifies the data set if you specify attribute modifications. To
ensure data set integrity, allocate the data set as OLD or be aware of the data set update
protection provided by StarTool FDM for SHR allocations. For details, see Appendix B,
"Update Protection".
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------ ISPMODE Session Display --------------------- ROW 691 OF 733
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.LINK.LOAD,VOL=SER=STR804 MEM=PDS* ----------------------------
>----->at pds*
PDS020I PDSPGM Attributes are: RENT, REUS
PDS120I Residence Mode is ANY -- addressing mode is 31
PDS103I Entry point at 00000000 -- WHAT
PDS104I Module length 0006CFA8 -- 436K
PDS064I Last link-edited on 02/06/10 by LKED 566528408 V71 M00
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
-------------- ISPMODE Session# 2 Log# 1 --------------- ROW 868 TO 889 OF 889
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.LINK.LOAD,VOL=SER=SER007 MEM=(#OPCODE --------------------
>----->at = rent
PDS167I ATTRIB will change the following members: #OPCODE, #OPCODEM, #OPCODE2
PDS396A Should ATTRIB continue (Yes/No) ?
>----->y
PDS020I #OPCODE Attributes are: RENT, REUS, REFR
PDS103I Entry point at 00000000 -- OPTESTCD
PDS104I Module length 000008E0 -- 3K
PDS064I Last link-edited on 02/12/20 by LKED 566528408 V03 M01
In the screen display above, the LKED value in message PDS046I is replaced with a coded
value to represent the actual linkage editor or program binder used for the listed CSECT.
StarTool FDM determines this through inspection of the IBM component codes carried in
the load module. For more information about the IBM component codes, see message
PDS046I in the StarTool FDM Messages Guide.
BLK3380 Subcommand
The BLK3380 subcommand computes an optimal block size for placing a data set on a
3380 disk pack. The program output includes the following reports:
1 A summary block size report for the given LRECL and key length that includes the
recommended block size to use.
Example
BLK3380 133
Syntax
BLK3380 lrecl [KEYLENGTH(keylen) ]
[TRACKCAP / NOTRACKCAP ]
[BLKSIZE(blklen) ]
Command Reference 65
Chapter 3 Commands — A to C
[NUMBER(#rec) / RECORDS(#rec) ]
[VERIFY ]
Aliases
BLK338, BLK3380
Defaults
KEYLENGTH(0), NOTRACKCAP, BLKSIZE(RECOMMENDED VALUE), NUMBER(100000)
Required
lrecl
Operands
lrecl The logical record length of the data that is to be placed in the
data set.
KEYLENGTH(kl) The key length, in bytes, of the keys to be used in the data set.
The maximum legal key length is 255.
TRACKCAP Specifies a track capacity report for the device using the
specified (or default) key length.
A track capacity report is provided if NOTRACKCAP is not
specified and lrecl exceeds the maximum block size for a track
or BLKSIZE exceeds the maximum block size for a track.
NOTRACKCAP Specifies that a track capacity report is not wanted.
BLKSIZE(blklen) The block size to use for the allocation computation. If you do
not enter blklen (or you enter zero), the program’s
recommended block size is used.
NUMBER(#rec) Number of logical records in the data set.
RECORDS(#rec) Number of logical records in the data set.
VERIFY Specifies that the TRKCALC routine is to be used to verify track
capacity calculations. If you use VERIFY, the number of calls to
TRKCALC is output at the end of the output. With VERIFY on,
you need a minimum of 34 calls for a track capacity table;
otherwise, you need a minimum of 17 calls for the track
capacity table.
Remarks
The recommended block size value is for data sets in which the predominant access is
sequential. For data sets where random access time is critical or the usual access is
random, use a small block size (500 - 2000 bytes).
The recommended block size tends to be near a half-track figure since this is the most
efficient in terms of the trade-offs among buffer size, secondary storage requirements,
channel use, number of input/outputs, and overall processing time. This figure is only a
general guide; for maximum efficiency considering other factors, study the generated
block size summary report or a track capacity report.
The program assumes a large amount of data is to be stored. Place data sets that occupy
a few tracks in partitioned data sets. If not possible, use a small block size (2400 - 4000
bytes).
This interface is optional. Use it if your installation installed the public domain BLK3380
subcommand.
BLK3390 Subcommand
The BLK3390 subcommand computes an optimal block size for placing a data set on a
3390 disk pack. The program output includes the following reports:
1 A summary block size report for the given LRECL and key length that includes the
recommended block size to use.
Command Reference 67
Chapter 3 Commands — A to C
Example
BLK3390 121
Syntax
BLK3390 lrecl [KEYLENGTH(keylen) ]
[TRACKCAP / NOTRACKCAP ]
[BLKSIZE(blklen) ]
[NUMBER(#rec) / RECORDS(#rec) ]
[VERIFY ]
Aliases
BLK339, BLK3390
Defaults
KEYLENGTH(0), NOTRACKCAP, BLKSIZE(RECOMMENDED VALUE), NUMBER(100000)
Required
lrecl
Operands
lrecl The logical record length of the data to be placed in the data
set.
KEYLENGTH(kl) The key length, in bytes, of the keys to be used in the data set.
The maximum legal key length is 255.
TRACKCAP A track capacity report for the device using the specified (or
default) key length.
A track capacity report is provided if NOTRACKCAP is not
specified and lrecl exceeds the maximum block size for a track
or BLKSIZE exceeds the maximum block size for a track.
NOTRACKCAP Do not provide a track capacity report.
BLKSIZE(blklen) The block size to use for the allocation computation. If you do
not enter blklen (or you enter zero), the program’s
recommended block size is used.
NUMBER(#rec) Number of logical records in the data set.
RECORDS(#rec) Number of logical records in the data set.
VERIFY Use the TRKCALC routine to verify track capacity calculations. If
you use VERIFY, the number of calls to TRKCALC is output at the
end of the output. With VERIFY on, you need a minimum of 34
calls for a track capacity table; otherwise, you need a minimum
of 17 calls for the track capacity table.
Remarks
The recommended block size value is for data sets in which the predominant access is
sequential. For data sets where random access time is critical or the access is random,
use a small block size (500 - 2000 bytes).
The recommended block size tends to be near a half-track since this is considered the
most efficient in terms of the trade-offs among buffer size, secondary storage
requirements, channel use, number of input/outputs, and overall processing time. This is
only a general guide; for maximum efficiency, considering other factors, study the
generated block size summary report or a track capacity report.
The program assumes a large amount of data to be stored. Place data sets that occupy
only a few tracks in partitioned data sets. If this is not possible, use a small block size
(2400 - 4000 bytes).
This interface is optional; use it if your installation installed the public domain BLK3390
subcommand.
BLK9345 Subcommand
The BLK9345 subcommand computes an optimal block size for placing a data set on a
9345 disk pack. The program output includes the following reports:
Command Reference 69
Chapter 3 Commands — A to C
1 A summary block size report for the given LRECL and key length that includes the
recommended block size to use.
Example
BLK9345 80
Syntax
BLK9345 lrecl [KEYLENGTH(keylen) ]
[TRACKCAP / NOTRACKCAP ]
[BLKSIZE(blklen) ]
[NUMBER(#rec) / RECORDS(#rec) ]
[VERIFY ]
Aliases
BLK9, BLK93, BLK934, BLK9345
Defaults
KEYLENGTH(0), NOTRACKCAP, BLKSIZE(RECOMMENDED VALUE), NUMBER(100000)
Required
lrecl
Operands
lrecl The logical record length of the data that is placed in the
data set.
KEYLENGTH(kl) The key length, in bytes, of the keys used in the data set.
The maximum legal key length is 255.
TRACKCAP A track capacity report for the device using the specified (or
default) key length.
A track capacity report is provided if NOTRACKCAP is not
specified and lrecl exceeds the maximum block size for a
track or BLKSIZE exceeds the maximum block size for a
track.
NOTRACKCAP Do not provide a track capacity report.
BLKSIZE(blklen) The block size to use for the allocation computation. If you
do not enter blklen (or if you enter zero), the program’s
recommended block size is used.
NUMBER(#rec) Number of logical records in the data set.
RECORDS(#rec) Number of logical records in the data set.
Remarks
The recommended block size value is for data sets in which the predominant access is
sequential. For data sets where random access time is critical or the access is random,
use a small block size (500 - 2000 bytes).
The recommended block size tends to be near a half-track figure since this is considered
the most efficient in terms of the trade-offs among buffer size, secondary storage
requirements, channel use, number of input/outputs, and overall processing time. This is
only a general guide; for maximum efficiency considering other factors, study the
generated block size summary report or a track capacity report.
The program assumes that a large amount of data is to be stored. Place data sets that
occupy only a few tracks in partitioned data sets. If this is not possible, use a small block
size (2400 - 4000 bytes).
This interface is optional; use it if your installation installed the public domain BLK9345
subcommand.
Command Reference 71
Chapter 3 Commands — A to C
BROWSE Subcommand
The BROWSE subcommand enters ISPF browse for a member.
Example
BROWSE mema:memb
Syntax
BROWSE memgroup
* [FROMKEY(key)/FROMADDRESS(add)/FROMNUMBER(num) ]
* [TOKEY(key)/TOADDRESS(add)/TONUMBER(num) ]
*NOTE: Lines with an asterisk are supported for VSAM with PBROWSE or
BRIF.
Aliases
B, BR, BRO, BROW, BROWS, BROWSE
Abbreviations
FKEY for FROMKEY, FADDR for FROMADDRESS, FNUM for FROMNUMBER, TKEY for TOKEY,
TADDR for TOADDRESS, and TNUM for TONUMBER
Defaults
memgroup
Required
None
Operands
memgroup Identifies the members to be browsed.
Default member names, member lists, member name ranges,
and member name patterns are allowed; for more
information, see Appendix A, "Formatting Member Names".
FROMKEY(ky) For VSAM data sets only, ky is the key of the first record to be
accessed. This is a generic key and can be coded as x’hexkey’.
Access begins at the first record whose key matches (or is
greater than) the portion of the key specified.
Use this parameter with TOKEY. It can be specified only for an
alternate index or a key-sequenced data set.
Remarks
If you enter a : for the member name position, an ISPF member selection list displays.
Display VSAM data sets with PBROWSE. You may have chosen a different interface during
StarTool FDM installation. Of the other interfaces, only BRIF supports the positioning
keywords such as FROMKEY. To determine the interface, type a CONTROL DEFAULT
Command Reference 73
Chapter 3 Commands — A to C
subcommand and look for an output line beginning BROWSE calls with one of the
following values:
BRIF – uses the ISPF BRIF interface which is up to 32760 characters wide
PBROWSE – uses PBROWSE services
REVIEW – uses the REVIEW command (a non-ISPF full screen public domain program)
%VSAMMBR – uses the MacKinney System VSAM Utility Browse
If the ISPF BRIF interface is in use, StarTool FDM keeps the records of a data set in high
region storage if the data set size does not exceed two megabytes or the data set is a
path (since a path cannot have unique keys). Records are provided to the BRIF service as
requested. If you “max down” to the end of the data set, this could take a considerable
amount of time. If the data set is in storage, subsequent positioning in the browse is
much faster.
CALC Function
The CALC command performs floating point calculations.
Example
CALC
Syntax
CALC
Aliases
CAL, CALC
Operands
No operands are supported for the CALC subcommand.
Remarks
The CALC ISPF table displays in response to a CALC command. When you are in a CALC
display, you have many options. Delete a part of the table, find data in the table, print a
part of the table, store a part of the table in a data set, and so on. For assistance with the
different options available, use the HELP command, CUA functions, or type an O command
as a primary command.
The CALC table displays the calculator tape for your calculator. Enter new calculations
from the CALC display.
The following primary commands are supported directly for the CALC function. For
information on ISPMODE commands available anywhere in StarTool FDM, see “Common
Commands” in Chapter 2, "ISPF Interface Commands".
RF[IND] Finds a string (repeat find) and positions the display start location. PF
keys 5 and 17 are normally set to RFIND.
X Clears the CALC table relative to the cursor position.
Syntax X [ABOVE/BELOW/ALL]
XA[LL] Clears the CALC table; this is equivalent to X ALL
CAX Function
The CAX command displays the names and attributes of active system catalogs in an ISPF
table.
Example
CAX
Syntax
CAX
Aliases
CAX, CAXW, CAXWA
Operand
No operands are supported for the CAX command.
Remarks
The CAX ISPF table displays in response to a CAX command. When you are in a CAX
display, you have many options. Delete a part of the table, sort the table in different
directions, find data in the table, print a part of the table, store a part of the table in a
Command Reference 75
Chapter 3 Commands — A to C
data set, and so on. For assistance with the different options available, use the HELP
command, CUA functions, or enter an O command as a primary command or as a line
command.
The CAX table displays the names of all active catalogs for your system and allows you to
enter LISTCAT-type line commands against them.
The catalogs are open at the time of the list. Use the information to fix suspected broken
catalogs. StarTool FDM does not fix catalogs, but the display of information on the open
catalogs aid in the diagnosis of the problems.
The results of line commands against the CAX list are captured in the StarTool FDM log.
Save them for later sessions in an alternate log.
The CAX table displays the active system catalogs and information about each catalog on
a line level: Type, Status, CAXWA address, relative entry number, volume name, and data
set name.
CAX Rebuilds the CAX table after you empty it with the XALL command).
EDITT[BL] (or Enters an edit session on CAX table data.
ET[BL])
EXPR[ESS] Executes all entered line commands without pauses between individual
commands.
L[OCATE] Positions to a data line in sorted tables by searching the current sorted
column for the specified data.
Syntax LOCATE number/dsname/volume
O[PTIONS] Provides primary command selection for CAX and operand syntax
assistance.
OUT[PUT] Outputs the CAX table to print or a data set.
Syntax OUTPUT [=c / F(ddname)]
RF[IND] Finds a string (repeat find) and positions the display start location. PF
keys 5 and 17 are set to RFIND.
SO[RT] Sorts function tables into an alternate order. SORT with no operands
sorts the table in default order, while SORT with a field name sorts the
table in that order.
Syntax SORT [NUMBER/DSNAME/VOLUME]
[ASCEND/DESCEND]
TAG Applies the specified line command to table entries marked with *TAG*
in the DATA/MSG field and executes each entry.
Syntax TAG linecmd
Command Reference 77
Chapter 3 Commands — A to C
Block line commands are doubled letters that delimit a range of table entries for which the
same action is to be performed. The CAX function supports the following block line
commands:
== = command. Repeats the previous line command for the range of lines.
*cm ERR- t=”Block line command,==”>
LL LOG command. Copies the range of lines into the log.
OO O command. Provides line command assistance for each line.
SS S command. Selects each line in the range of table lines.
XX X command. Drops the range of table lines.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------- Active Catalog Display ----------------------- ROW 1 OF 20
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.LIB.TEST,VOL=SER=STR815 MEM=: ---------------------------------
CMD DATA/MSG TYPE STATUS -ADDR- NUM VOLUME ---------DATA SET NAME ------
ICF ACTIVE A5B058 1 SPD801 CATALOG.ISPD801.CNA730
ICF ACTIVE A6E118 2 TESS05 CATALOG.ITESS05.CN3307
ICF ACTIVE A80100 3 STR502 CATALOG.ISTR502.CNA800
ICF ACTIVE A8F030 4 IBNK80 CATALOG.IIBNK80
ICF ACTIVE A95058 5 TES806 CATALOG.ITES806.CN3196
ICF ACTIVE AC1990 6 DDA500 CATALOG.IDDA500.CN3440
ICF ACTIVE AC8DB8 7 AION81 CATALOG.IAION81.CN3871
ICF ACTIVE AC8628 8 TES802 CATALOG.ITES802.TEMP
ICF ACTIVE AC86E0 9 ACCT01 CATALOG.IACCT01.CNA900
ICF ACTIVE AF6AD8 10 GLD800 CATALOG.IGLD800.CN3881
ICF ACTIVE AC8968 11 STR516 CATALOG.ISTR516.CNA800
ICF ACTIVE AC1030 12 FICO80 CATALOG.IFICO80.CN9100
ICF ACTIVE AD8280 13 STR501 CATALOG.ISTR501.CNA800
ICF ACTIVE AC83C8 14 STR504 CATALOG.ISTR504.CNA800
ICF ACTIVE AC8218 15 IAC800 CATALOG.IIAC800.CN2650
ICF ACTIVE AC8A80 16 STR503 CATALOG.ISTR503.CNA800
ICF ACTIVE AF68E0 17 STR505 CATALOG.ISTR505.CNA800
ICF ACTIVE AF7118 18 STR803 CATALOG.ISTR803.CNA850
CHANGE Subcommand
The CHANGE subcommand switches StarTool FDM to a different data set.
Example
CHANGE lib.cntl
Syntax
CHANGE {dsn [VOLUME(vser)/VOLSET(vdef)] [SHR/OLD] /
* / FILE(ddname) [NUMBER(num)]}
Aliases
STAR, START, STARTO, STARTOO, STARTOOL, C, CH, CHA, CHAN, CHANG, CHANGE
Defaults
SHR or previously used data set name and volume if no operand or * is entered.
Required
None
Operands
dsn Identifies the data set name. If the data set name is not entered
in single quotes (‘), your TSO PREFIX is appended to the start of
the entered data set name.
If you enter * in the data set name position, the previous set
name is assumed (you are switched from the current data set to
the previous data set with the * operand; another CHANGE *
switches data sets back again).
If your system has password security, type your data set
password after the data set name followed by a slash (/). The
syntax is dsn/password.
VOLUME(vser) Specifies the volume name on which the data set resides. If you
type a volume name, SYSALLDA is assumed as the unit name;
otherwise, use the unit name from the catalog.
Use this parameter if the data set is not cataloged or if the
catalog entry is not to be used. To use the catalog for a CHANGE
subcommand even if VOLSET is in effect, type VOLUME(*).
VOLSET(vdef) Specifies a default volume name for data set references. For
example, if you type VOLSET(NEWRES), subsequent CHANGE
subcommands with a data set name and no VOLUME parameter
assume a VOLUME(NEWRES) parameter.
Use this parameter if you want a default volume. To nullify the
effect of VOLSET, type VOLSET(*) on a subsequent CHANGE
subcommand.
SHR Allocates the data set with a disposition of SHR; allows
simultaneous use of this data set by others. SHR is
recommended.
OLD Allocates the data set with a disposition of OLD; does not allow
simultaneous use of this data set by others. SHR is
recommended.
FILE(ddname) Identifies the DDNAME of a pre-allocated data set. Only disk data
sets (including VIO) are supported. If you use the FILE keyword,
do not use dsn, SHR/OLD, VOLSET, and VOLUME. However, if the
data set is concatenated, use the SHR or OLD keyword since
StarTool FDM reallocates the data set.
NUMBER(num) Specifies the concatenation number for the DDNAME allocation
for the FILE keyword. num defaults to 1 but if num is larger than
the number of concatenated data sets, the last data set in the
sequence is used.
Command Reference 79
Chapter 3 Commands — A to C
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
--------------------------- ISPMODE Session Display ---------- ROW 430 OF 434
COMMAND ===> SCROLL ===> CSR
- DSN=WESTERN.RGN.LINK,VOL=SER=STR815 MEM=: ---------------
>----->c ‘western.rgn.link’
PDS200I DISP UNIT OPT RECFM LRECL BLKSIZE ALLOCTRK FREETRK SECONDARY FREEDIR
PDS200I SHR 3380 C FB 80 9040 1X 47 10 40 TRK 2
PDS223I This is a linklist data set; all linklist libraries are authorized
PDS189I This data set is managed by LLA
PDS224I This data set is APF authorized
PDS226I This data set has 2 free directory blocks
PDS298I There are 4 users allocated to this data set
CMDTBL Function
The CMDTBL function manages ISPF command tables. CMDTBL displays command tables
(by default, the current ISP command table is selected from the copy in memory) and
manipulates command table entries. Move, modify, and test Individual command table
entries in the CMDTBL function before saving the table.
The CMDTBL function builds, merges, or changes the edit mode of the command table.
After the CMDTBL function begins, shift left or right to see a double-line view of the
command table entries.
A command table contains the specifications of general commands that you can enter
from any panel during the execution of an application. Command table entries are
identified by an application ID. They are maintained in the ISPF table input library
(ISPTLIB).
Example
CMDTBL isp edit
Syntax
CMDTBL [appl / ISP / ISR / APPLTBL / SITETBL / USERTBL ]
[EDIT / NOEDIT ]
[NEW / TOP / BOTTOM / INSERT ]
[LIB(ddname) ]
Aliases
CMD, CMDT, CMDTB, CMDTBL
Defaults
ISP, NOEDIT, INSERT, LIB(ISPTLIB)
Required
None
Operands
appl A 1- to 4-character application name. ISP, ISR, APPLTBL, SITETBL,
and USERTBL applications are handled as special cases. The
associated table is retrieved from memory if it is active.
ISP Invokes CMDTBL with the ISP application.
ISR Invokes CMDTBL with the ISR application.
APPLTBL Invokes CMDTBL with the active application (normally, ISP or ISR).
SITETBL For ISPF 4.2 or above, invokes CMDTBL with the site-defined
application.
USERTBL For ISPF 4.2 or above, invokes CMDTBL with the user-defined
application.
EDIT Edits the command table.
NOEDIT Displays the command table.
NEW Creates a new command table.
TOP Adds a command table to the top of the current command table.
BOTTOM Adds a command table after the end of the current command table.
INSERT Inserts a command table after the top line being displayed of the
current command table.
LIB(ddname) ddname to use for reading the table library (this defaults to
ISPTLIB).
Remarks
If CMDTBL is already active, the default APPL name is the current name and no merge is
done. Use with EDIT or NOEDIT to change the mode. For ISP, ISR, APPLTBL, SITETBL, or
USERTBL, LIB is ignored and the in-memory copy is used.
After entering a command, ISPF searches the application command table (if one exists)
and then the system command table (ISP or ISR). If it finds the command, ISPF takes the
proper action immediately; otherwise, ISPF passes the command through to the dialog
without changes in the COMMAND field.
Command Reference 81
Chapter 3 Commands — A to C
The following primary commands are supported directly for the CMDTBL function; for
documentation on ISPMODE commands available anywhere in StarTool FDM, see
“Common Commands” in Chapter 2, "ISPF Interface Commands".
APP[LY] Applies the specified line command to all table entries and
executes each entry.
Syntax APPLY linecmd
IN[SERT] Adds 10 blank lines to the current command table after the
current row displayed at the top of the screen.
O[PTIONS] Provides primary command selection for the CMDTBL
function and operand syntax assistance.
OUT[PUT] Outputs the command table to print or a data set.
Syntax OUTPUT [=c / F(ddname)]
RF[IND] Finds a string (repeat find) and positions the display start
location. PF keys 5 and 17 are normally set to RFIND.
SA[VE] Updates the table to a data set or in memory.
Syntax SAVE appl / ISP / ISR
[REPLACE] [NOCHECK] [LIB(ddname)]
Command Reference 83
Chapter 3 Commands — A to C
Block line commands are doubled letters that delimit a range of table entries for which the
same action is to be performed. The following block line commands are supported in the
CSECTS function:
== = command. Repeats the previous line command for the range of lines.
*cm ERR- t=”Block line command,==”>
CC C command. Copies block.
DD D command. Deletes block.
MM M command. Moves block.
RR R command. Repros block.
XX X command. Drops the range of table lines.
LISTC 0 &PDSPASS
---- PDS/USER CONTROLLED PASSTHRU
PLIST 2 SELECT CMD(STARTOOL F(ISPPROF) ISPXEQS LISTC 20 PROMPT
---- StarTool PLIST facility
TOP 0 ALIAS UP MAX
---- SCROLL TO TOP
BACKWARD 0 ALIAS UP
---- SCROLL UP
UP 0 SETVERB
---- SCROLL UP
BOTTOM 0 ALIAS DOWN MAX
---- SCROLL TO BOTTOM
TRYPAN 0 SELECT PANEL(&ZPARM)
---- SELECT A PANEL
COMBINE Subcommand
The COMBINE subcommand joins members together in an IEBUPDTE format. Any ISPF
statistics are preserved and a ./ in the input members is translated to >< in the output.
COMBINE supports record lengths beyond 256 characters.
Example
COMBINE pep* output.data(savmemb)
Syntax
COMBINE memgroup
dsname [VOLUME(volser)]
[IEBUPDTE/TITLE/NOSEP ]
[SEPCHAR(dd) ]
[TRANSFROM(ab) ]
[TRANSTO(cd) ]
[CALL/NOCALL ]
[SUMMARY/LIST/NOLIST ]
[OLD/SHR / MOD / NEW [BLK/TRK/CYL]
[DIR(num)] [SPACE sec)]]
[ROUND] [EXPDT(yyddd)/RETPD(nnnn)]
[RLSE]
[STORCLAS(sclass)] [MGMTCLAS(mclass)]
[DATACLAS(dclass)] [DSNTYPE(LIBRARY/PDS)]
Aliases
COMB, COMBI, COMBIN, COMBINE
Defaults
memgroup, SHR, IEBUPDTE, SEPCHAR(./)
Required
memgroup, dsname
Operands
memgroup Identifies the group of members to be joined together.
Default member names, member lists, member name ranges,
and member name patterns are allowed; for more
information, see Appendix A, "Formatting Member Names".
dsname Specifies the output data set (and member if partitioned)
using standard TSO syntax.
Command Reference 85
Chapter 3 Commands — A to C
VOLUME(volser) For NEW data sets, specifies the output volume name; for
existing data sets, use this parameter if the output data set is
not cataloged. For new data sets, code VOLUME(*) to mean
the volume parameter is to be copied.
IEBUPDTE Records output in IEBUPDTE format (add a “./ ADD NAME=”
statement before each output member and preserve ISPF
statistics).
TITLE Places a title line between output members giving the member
and data set name.
NOSEP Places no separators between output members.
SEPCHAR(dd) Names the IEBUPDTE type separator to place between
members (usually ./).
TRANSFROM(ab) Defaults to ./. A character string is translated to the TRANSTO
string if found in column one of the input stream.
TRANSTO(ab) Defaults to <>. A character string is substituted for the
TRANSFROM string if found in column one of the input stream.
CALL Invokes the copy program.
NOCALL Do not invoke the copy program; member checking and data
set allocations are still performed.
SUMMARY Display only summary and error messages.
LIST Display all messages.
NOLIST Display no messages.
SHR Allows shared use of the output data set; StarTool FDM
provides output data set protection. See Appendix E Appendix
B, "Update Protection".
OLD Obtains exclusive use of the output data set.
MOD For sequential output, obtains exclusive use and adds to the
end of the data set.
NEW Creates the output data set. When you specify NEW, specify
BLK/TRK/CYL, DIR, SPACE, ROUND, EXPDT (or RETPD), RLSE,
STORCLAS, MGMTCLAS, DATACLAS, and DSNTYPE keywords.
DIR(num) The number of directory blocks for the output data set. If you
do not enter DIR, the default is taken from the input data set.
SPACE(prim,sec) The primary and secondary quantities for the output data set
in track or cylinder units.
If you do not enter BLK, TRK, or CYL but you enter SPACE,
space allocation units are assumed the same as the current
allocation.
BLK Allocates the output data set in blocks. If you enter BLK
without SPACE, the space allocation units are taken from the
current allocation and converted to equivalent block units.
TRK Allocates the output data set in tracks. If you enter TRK
without SPACE, the space allocation units are taken from the
current allocation and converted to equivalent track units.
CYL Allocates the output data set in cylinder units. If you enter CYL
without SPACE, the space allocation units are taken from the
current allocation and converted to equivalent cylinder units.
ROUND Used with BLK to specify that the data set allocation be
rounded up to cylinder boundaries.
EXPDT(yyddd) The expiration date for the data set. On and after the
expiration date, delete or write over the data set. Use
EXPDT(yyyyddd).
RETPD(nnnn) Number of days (0 to 9999) for your data center to keep the
data set.
RLSE Release unused space in the data set after the copy.
STORCLAS(sc) Storage class for the data set. Use this parameter to identify
performance and availability requirements for data sets. Use it
instead of UNIT and VOLUME keywords for SMS managed data
sets to determine where the data set is allocated. To nullify
this parameter, type STORCLAS(*).
MGMTCLAS(mc) The management class for the data set. It establishes the
migration, backup, and space release characteristics for SMS-
managed data sets. To nullify this parameter, type
MGMTCLAS(*).
DATACLAS(dc) The data class for the data set. It provides data attributes
such as RECFM, KEYLEN, SPACE, EXPDT or RETPD, DSORG,
LRECL, and some VSAM SHR options for SMS-managed-data
sets. To nullify this parameter, type DATACLAS(*). Use
DATACLAS for data sets that are not SMS managed.
DSNTYPE(typ) Specify typ as LIBRARY for a PDSE or PDS for a partitioned
data set. A PDSE must be a SMS-managed data set.
Remarks
Use the COMBINE subcommand to consolidate members into a single data set or member.
ISPF statistics are preserved, if possible, and IEBUPDTE controls in a member are
converted to >< control statements.
COMBINE and SEPARATE are paired subcommands. To join members into a combined
member or data set, use the COMBINE subcommand. To split the members apart again,
use the SEPARATE subcommand or IEBUPDTE if the logical record length is 80.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
----------------- ISPMODE Session# 1 Log# 1 ------------- Row 531 to 541 of 541
COMMAND ===> SCROLL ===> CSR
- DSN=WSER07.LIB.PDSE,VOL=SER=SER003 MEM=(#MDSECT --------------------------
>------>combine * lib.cntl(download)
PDS290I COMBINE is in progress
PDS051I #MDSECT was combined; input=1,656; output=1,657
PDS051I @FILEXID was combined; input=5,852; output=5,853
PDS051I @FILEPAR was combined; input=2,264; output=2,265
PDS051I @SERVICE was combined; input=5,685; output=5,686
PDS051I @VERIFY was combined; input=1,953; output=1,954
PDS051I PDS0520 was combined; input=472; output=473
Command Reference 87
Chapter 3 Commands — A to C
COMPARE Subcommand
The COMPARE subcommand displays differences between two members. Use the TSO
COMPARE command. Add COMPARE operands after the member names.
If the current data set is not partitioned, code an * in the data set name position to
compare the current data set to a different data set.
To compare directory entries between two libraries, use the COMPDIR subcommand. See
the “COMPDIR Subcommand”.
Example
COMPARE oldmem other.lib(newmem)
Syntax
COMPARE oldmemb newmemb [DELTA ]
[OVSUM ]
[CHNG ]
[SEQ/NOSEQ ]
[COBOL ]
[OVOL(volname)]
[NVOL(volname)]
Aliases
CO, COM, COMP, COMPA, COMPAR, COMPARE
Defaults
DELTA
Required
oldmemb, newmemb
Operands
oldmemb Base member to be compared with newmemb. oldmemb can be a
data set and member name if a member from a different data set
is used.
newmemb New member to be compared with oldmemb. newmemb can be a
data set and member name if a member from a different data set
is used.
If you code this operand as the name of a partitioned data set
with no member name, the base member name is used. Use this
to compare two different levels of the same module.
Remarks
Use the TSO COMPAREW (preprocessor to COMPAREX), COMPAREC (pre-processor to
SuperC), or COMPARE$ (the Yale compare command). This choice is made during StarTool
FDM installation. To determine which program is used, type a CONTROL DEFAULT
subcommand and look for an output line beginning COMPARE calls.
This interface is optional. Use it if COMPAREX, SuperC, or the Yale compare program is
installed at your installation.
COMPDIR Subcommand
The COMPDIR subcommand creates a sublist based on differences or similarities between
data sets.
Example
COMPDIR pep* file(ispplib)
DEL *
Syntax
COMPDIR memgroup
{/ or dsname [VOLUME(volser)] / * / FILE(ddname) [NUMBER(numb)]}
[ALIAS/NOALIAS ]
[AS(pname) / TO(pname) ]
[SUBSTITUTE(oldstring/newstring)]
[SEQ/NOSEQ ]
[EXIST/NOEXIST/CHANGED/NOCHANGED/DIRCHANGE/NODIRCHANGE]
[MEMBERS/MEMLIST/ML/NEWML/SUBLIST]
Aliases
COMPD, COMPDI, COMPDIR
Defaults
memgroup, NOALIAS, EXIST, SUBLIST
Required
memgroup, dsname, or * or FILE(ddname)
Command Reference 89
Chapter 3 Commands — A to C
Operands
memgroup Group of members to be compared to those in the other
data set.
Default member names, member lists, member name
ranges, and member name patterns are allowed. For more
information, see Appendix A, "Formatting Member Names".
dsname Comparison data set. Use standard TSO dsname syntax. If
you enter * in the dsname field, the previously used data
set name used for a COPY or COMPDIR subcommand is
used.
As an alternative to the AS or TO keywords, enter partial
member names in parentheses following the data set
name, as in this example: the.dsn(pname)
VOLUME(volser) For uncataloged data sets, identifies the output data set
volume name.
FILE(ddname) The output data set is already allocated with the provided
ddname. Only disk data sets are supported.
NUMBER(numb) Concatenation number for the DDNAME identified. numb
defaults to 1. If numb is larger than the number of
concatenated data sets, the last data set in the
concatenation sequence is used.
ALIAS Adds associated members (aliases, apparent aliases, and
associated main members) to the list of names to check.
NOALIAS Adds only specifically identified member names to the
sublist of members.
AS(pname) pname defines the name of any comparison members. For
example, with AS(new) and the input members AA, ABBA,
and IBM04, members named NEW, NEWA, and NEW04 are
compared. AS and TO are equivalent keywords.
If only a single member is entered and the ALIAS keyword
is not entered, the resulting member name is taken only
from the AS or TO keyword.
TO(pname) pname defines the name of any comparison members. For
example, with TO(new) and the input members AA, ABBA,
and IBM04, members named NEW, NEWA, and NEW04 are
compared. TO and AS are equivalent keywords.
If only a single member is entered and the ALIAS keyword
is not entered, the resulting member name is taken only
from the AS or TO keyword.
SUBSTITUTE(old,new) Used with a forward slash (/) to represent the current data
set name. Use SUBSTITUTE to replace a string of
characters in the source data set name to create a target
data set name.
For example, if the current data set is PDSEXXX.MSGS, the
following two subcommands are equivalent:
COMPDIR ABC* PDSEYYYY.MSGS
COMPDIR ABC* / SUBSTITUTE(XXX/YYYY)
EXIST Searches for members from the current member group
that are also present in the compare data set.
Remarks
The COMPDIR subcommand compares two libraries that contain members with a known
relationship (for example, a library containing a new level of a software product or a new
‘SYS1.PARMLIB’ for a system in test mode).
Command Reference 91
Chapter 3 Commands — A to C
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
---------------- ISPMODE Session# 1 Log# ----------- ROW 990 TO 1,007 OF 1,033
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.LIB.CLIST,VOL=SER=SER002 MEM=(COMPR -------------------
>----->compdir : lib.clistv noexist
PDS175I The member names have been compared
PDS176I 63 members initially; 33 members dropped
PDS165I Members are: COMPR, DSP, MIGR8, NOMG8DSN, NOMIGR8, NULL, NULL2,
PCLIST1, PDSABEND, PDSCALL, PDSCLIS, PDSN, PDSNN, PDSSE, PDSTR, QW,
QWO, SCPASMCL, SPIFFY, SPZAP, SSCT, SSUS, SSVT, SYNTAX, TESTCLS,
TESTJUMP, TESTPDST, TESTPRIM, TRYREX, VOLUME
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
--------------- ISPMODE Session# 2 Log# 1 -------------- ROW 584 TO 595 OF 595
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.LIB.PDSE310,VOL=SER=SER006 MEM=(PDSZA@C ------------------------
>----->compdir pdsz* lib.pdse221 changed
PDS175I The data has been compared
PDS176I 84 members initially; 47 members dropped
FUNCTIONS CONTROL A-M LINE CMDS A-M DSN CMDS MEM CMDS A-M FEATURES
CONTROL N-Z LINE CMDS N-Z MEM CMDS N-Z DEFAULTS
--------------- Source MEMLIST 1, Session# 1 --------------- Row 1 to 25 of 37
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.LIB.PDSE310,VOL=SER=SER006 MEM=(PDSZA@C ------------------------
CMD NAME DATA/MSG VER.MOD CREATED LAST MODIFIED SIZE INIT ID
PDSZA@C
PDSZA@P
PDSZABA
PDSZAID
PDSZALLO
PDSZALOC
PDSZAOF
PDSZATB
PDSZATTR
PDSZAUTH
PDSZAZA
PDSZCHAN
PDSZCOMA
PDSZCONT
COMPRESS Subcommand
The COMPRESS subcommand invokes IEBCOPY (or a compatible program) to compress a
partitioned data set.
For a PDSE data set, the COMPRESS subcommand invokes the COPY subcommand to
reorganize the data set as follows:
1 If you have proper access authority for the source data set, a COPY subcommand is
issued with the COPYBACK keyword.
3 All members are copied into the new temporary target data set.
4 The source PDSE is reset to NEW status (all members are deleted).
5 All members are copied back into the source data set.
Example
COMPRESS summary
Syntax
COMPRESS [SUMMARY / LIST / NOLIST TRIM]
Command Reference 93
Chapter 3 Commands — A to C
Aliases
COMPR, COMPRE, COMPRES, COMPRESS
Defaults
SUMMARY
Required
None
Operands
SUMMARY Displays only compress summary and error messages.
LIST Displays all compress messages.
NOLIST Displays no compress messages.
TRIM After the compress operation, trim the data set as follows:
For a PDS data set, release any unused extents as for FIXPDS RELEXT
For a PDSE data set, release all unused tracks as for FIXPDS RELEASE
Remarks
You may have chosen any one of several interfaces during StarTool FDM installation. To
determine which interface you selected, type a CONTROL DEFAULT subcommand and look
for an output line beginning COMPRESS calls. Any of the following are supported:
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------------------------------------------------------------
--------------------------- ISPMODE Session Display ------------ ROW 14 OF 19
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.LINK.LOAD,VOL=SER=STR804 MEM=(CPX623 -------------------------
>----->compress
IEB144I THERE ARE 0000124 UNUSED TRACKS IN OUTPUT DATA SET
IEB149I THERE ARE 0000025 UNUSED DIRECTORY BLOCKS IN OUTPUT DIRECTORY
IEB147I END OF JOB -00 WAS HIGHEST SEVERITY CODE
PDS200I DISP UNIT OPT RECFM LRECL BLKSIZE ALLOCTRK FREETRK SECONDARY FREEDIR
PDS200I SHR 3390 C FB 80 32720 26X 63 33 1 TRK NOLIMIT
CONDEND Subcommand
Use the CONDEND subcommand to terminate StarTool FDM if the previous subcommand
has one or more warning or error level messages. The return code is set to the numeric
value of the message that terminated StarTool FDM. After StarTool FDM terminates by
CONDEND, the return code is in the range of 400 to 999; however, if RC is entered, it is
translated to 4 or 8.
Command Reference 95
Chapter 3 Commands — A to C
Example
CONDEND exit(450)
Syntax
CONDEND [WARNINGS/ERRORS/EXIT(n1,n2, ...)/NOEXIT(n1,n2, ...)]
RC
Aliases
COND, CONDE, CONDEND
Defaults
WARNINGS
Required
None
Operands
WARNINGS Exit if any message issued by the last subcommand was in the range
PDS400W through PDS999E (warning or error messages).
ERRORS Exit if any message issued by the last subcommand was in the range
PDS600E through PDS999E (error messages).
EXIT Exit if a named warning or error message was issued by the last
subcommand. For example, to exit for a PDS450W, PDS715E, or
PDS823E message, type CONDEND EXIT(450,715,823)
NOEXIT Exit for any warning or error message except for those messages in
an exemption list. For example, to exit for any warning or error
message except PDS460W, PDS958E or PDS609E, type
CONDEND NOEXIT(460,958,609)
RC Translates the return code to four if the terminating message was
between PDS400W through PDS599W or eight if the terminating
message was between PDS600E and PDS999E.
Remarks
Use this subcommand to check that a critical subcommand in a CLIST is working as
expected. StarTool FDM CLIST continues to execute after receiving program warning or
error messages. With this facility, terminate a StarTool FDM CLIST process when it is not
functioning properly. You can detect this problem from a driving CLIST by examining
&LASTCC.
Put CONDEND statements in your CLIST just after any critical subcommands.
CONTROL Subcommand
The CONTROL subcommand specifies global and immediate processing options.
Example
CONTROL DSNAME(lib.cntl(pdsdata)) OLD
Syntax
CONTROL [ALIASINFO|NOALIASINFO]
[LKEDDATE|NOLKEDDATE]
[PROMPT|NOPROMPT]
[RECOVER|NORECOVER]
[TRANSLATOR|NOTRANSLATOR]
[SINGLE|DOUBLE|MULTIPLE|RETAIN(ntrk)]
[INFO|NOINFO]
[PUTLINE|NOPUTLINE]
[COMMAND|NOCOMMAND]
[SYSOUT(c)
{FORM(ffff)|NOFORM|DEST(destination)|NODEST}|
DSNAME(memb) {OLD|MOD|NEW|SHR}|
NODSN|
NOSYSOUT]
[DEFAULTS|IOSTATS|LISTENV|RESTRICTED|TESTABEND|TESTMSGS|
TESTOUTLOOP|TESTPARSE|TESTREAD|TESTSYNTAX]
Aliases
CON, CONT, CONTR, CONTRO
Defaults
Initially in TSO: ALIASINFO, LKEDDATE, PROMPT, RECOVER, TRANSLATOR, RETAIN(9)
Initially in the background: ALIASINFO, LKEDDATE, NOPROMPT, NORECOVER,
TRANSLATOR, RETAIN(9)
Required
None
Operands
ALIASINFO Provides alias information for ATTRIB subcommands. Also
provides alias information for MAP subcommands with alias
members if MAP has no CSECT-limiting parameters.
NOALIASINFO Provides no alias or main member identification for ATTRIB
and MAP subcommands.
Command Reference 97
Chapter 3 Commands — A to C
Command Reference 99
Chapter 3 Commands — A to C
Remarks
Most CONTROL subcommand operands (such as ALIASINFO, SINGLE, and TESTPARSE)
are global in that they remain in effect until reset by another CONTROL subcommand. The
other operands (such as TESTABEND and IOSTATS) are immediate and take effect for only
a single CONTROL subcommand.
CONTROL does not use ISPF services; however, if StarTool FDM is invoked from READY
mode, StarTool FDM attempts to establish an ISPF environment for the first CONTROL
subcommand containing a SYSOUT or DSN keyword so that subsequent subcommands
can use ISPF services.
The input buffering type (BPAM, SINGLE, DOUBLE, MULTIPLE, or RETAIN) is reset for each
data set allocated according to the data set organization or the device type on which the
data set resides. RETAIN buffering is used for device types that support the READ
MULTIPLE CCW. DOUBLE is used otherwise. BPAM mode is selected automatically for PDSE
data sets and cannot be selected explicitly.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
---------------------- ISPMODE Session Display ---------------- ROW 447 OF 455
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.LIB.TEST2,VOL=SER=STR815 MEM=: -------------------------------
>----->control retain(9)
NOTE Be aware that values displayed for real and extended storage in message PDS052
on the CONTROL LISTENV panel may not be accurate when VARY STOR commands are in
progress.
COPY Subcommand
The COPY subcommand builds copy control statements and invokes a copy program to
selectively copy members to another data set.
Example
COPY mem1:mem2 other.dataset new tra spa(5,5) dir(20)
Syntax
COPY memgroup
{/ or dsname [VOLUME(volser)] / * / FILE(ddname) [NUMBER(numb)]}
[OLD/SHR / NEW [BLK/TRK/CYL] [DIR(num)] [SPACE sec)]]
[ROUND] [EXPDT(yyddd)/RETPD(nnnn)] [RLSE]
[STORCLAS(sclass)] [MGMTCLAS(mclass)]
[DATACLAS(dclass)] [DSNTYPE(LIBRARY/PDS)]
[UNCTLG/NOCATLG]
[ALIAS/NOALIAS ]
[AS(pname) / TO(pname) ]
[CALL/NOCALL ]
[COPYBACK ]
[EXIST/NOEXIST/EXCLUDE/NOBLDL]
[MAXBLK(num) ]
[REPLACE/NOREPLACE ]
[SUMMARY/LIST/NOLIST ]
[UNIT(Unitname) ]
[CHANGE/GO/TRIM ]
[NODUP ]
[ADDZAP/ADDZAP(number) ]
[NONUM/SNUM ]
[CLIST/NOCLIST ]
[REXX ]
[MOVE ]
[SUBSTITUTE(oldstring/newstring)]
* [FROMKEY(key)/FROMADDRESS(add)/FROMNUMBER(num) ]
* [TOKEY(key)/TOADDRESS(add)/TONUMBER(num) ]
Aliases
COP, COPY
Abbreviations
FKEY for FROMKEY, FADDR for FROMADDRESS, FNUM for FROMNUMBER, TKEY for TOKEY,
TADDR for TOADDRESS, and TNUM for TONUMBER.
Defaults
ALIAS if LOAD, NOALIAS otherwise; SHR, CALL, NOREPLACE, SUMMARY; if NEW is
specified, BLK/TRK/CYL, DIR, SPACE, ROUND, EXPDT, STORCLAS, MGMTCLAS, DATACLAS,
and DSNTYPE default to values used for the input data set.
Required
memgroup, dsname or * or FILE(ddname)
Operands
memgroup The members to be copied to the target data set.
Default member names, member lists, member name
ranges, and member name patterns are allowed; for more
information, see Appendix A, "Formatting Member Names".
dsname The output data set. Use TSO dsname syntax or a
temporary data set name such as ‘&&TEMP’. If you enter *
in the dsname field, the previously used data set name (for
a COPY command) is used instead. As an alternative to the
AS or TO keywords, enter partial member names in
parentheses following the data set name, as in this
example: the.dsn(pname)
VOLUME(volser) For NEW data sets, specifies the output volume name. For
existing data sets, use this parameter if the output data set
is not cataloged. For new data sets, code VOLUME(*) to
mean the volume parameter is to be copied.
FILE(ddname) The output data set is already allocated with the provided
ddname. Only disk data sets are supported. If you use the
FILE format, then do not use dsname, OLD, SHR, NEW,
RLSE, and data set allocation keywords.
If the data set is concatenated, use the SHR or OLD
keyword since StarTool FDM reallocates the output data
set.
NUMBER(numb) The concatenation number for the DDNAME identified.
numb defaults to 1. If numb is larger than the number of
concatenated data sets, the last data set in the
concatenation sequence is used.
OLD Obtains exclusive use of the output data set.
SHR Allows shared use of the output data set. StarTool FDM
provides output data set protection. See Appendix B,
"Update Protection".
NEW Creates the output data set. When you specify NEW, also
specify BLK/TRK/CYL, DIR, SPACE, ROUND, EXPDT (or
RETPD), RLSE, STORCLAS, MGMTCLAS, DATACLAS, and
DSNTYPE keywords.
DIR(num) The number of directory blocks for the output data set. If
you do not enter DIR, the default is taken from the input
data set.
SPACE(prim,sec) If you do not enter BLK, TRK, or CYL but you enter SPACE,
the space allocation units are assumed the same as the
current allocation.
BLK Allocates the output data set in blocks. If you enter BLK
without SPACE, the space allocation units are taken from
the current allocation and converted to equivalent block
units.
TRK Allocates the output data set in tracks. If you enter TRK
without SPACE, the space allocation units are taken from
the current allocation and converted to equivalent track
units.
CYL Allocates the output data set in cylinder units. If you enter
CYL without SPACE, the space allocation units are taken
from the current allocation and converted to equivalent
cylinder units.
ROUND Used with BLK to specify that the data set allocation be
rounded up to cylinder boundaries.
EXPDT(yyddd) The expiration date for the data set. On and after the
expiration date, delete or write over the data set. Also use
the format EXPDT(yyyyddd).
RETPD(nnnn) The number of days (0 to 9999) for your data center to
retain the data set.
RLSE Any unused space in the data set be released after the
copy operation.
STORCLAS(sc) The storage class for the data set. Use this parameter to
identify performance and availability requirements for data
sets. Use this parameter instead of UNIT and VOLUME
keywords for SMS managed data sets to determine where
the data set is allocated. To nullify this parameter, type
STORCLAS(*)
MGMTCLAS(mc) The management class for the data set. This parameter
establishes the migration, backup, and space release
characteristics for SMS managed data sets. To nullify this
parameter, type MGMTCLAS(*)
DATACLAS(dc) The data class for the data set. Use this parameter to
provide data attributes such as RECFM, KEYLEN, SPACE,
EXPDT or RETPD, DSORG, LRECL and some VSAM SHR
options for SMS managed data sets. To nullify this
parameter, type DATACLAS(*)
Use DATACLAS for data sets that are not SMS
managed.
DSNTYPE(typ) Specify typ as LIBRARY for a PDSE or PDS for a partitioned
data set. A PDSE must be a SMS managed data set.
UNCATLG Does not catalog the NEW data set.
NOCATLG Does not catalog the NEW data set.
ALIAS Copies any associated members (aliases, apparent aliases,
and associated main members).
NOALIAS Copies only the members specifically identified.
CHANGE StarTool FDM should CHANGE to the output data set at the
end of the COPY process.
GO StarTool FDM should initiate a GO session for the output
data set at the end of the COPY process.
TRIM After the copy operation, trim the source data set.
For a PDS data set, release any unused extents as for
FIXPDS RELEXT
For a PDSE data set, release all unused tracks as for FIXPDS
RELEASE
NODUP Does not use internal copy routines. Call an external copy
utility.
ADDZAP For load members only, specifies that a ZAP IDR record is
to be added (each ZAP IDR record contains space for 19
historical entries).
ADDZAP(n) For load members only, specifies that one or more ZAP IDR
records are to be added (each ZAP IDR record contains
space for 19 historical entries).
NONUM For source members only, specifies that the input members
are all data and no sequence numbers are to be formatted.
This keyword is ignored on a RECFM=F to RECFM=V CLIST
conversion.
SNUM For source members only, specifies that sequence numbers
in the input (the first eight columns for RECFM=V data
sets; otherwise the last 8 columns) are to be discarded
during the copy.
NOCLIST Do not perform CLIST conversion. CLIST conversion is
performed if RECFM=V, LRECL=255 data is copied to
RECFM=F, LRECL=80 or the reverse. CLIST conversion
entails assigning a new sequence number and breaking up
long lines into several short ones while maintaining normal
CLIST format rules.
CLIST Invokes an internal copy routine and converts CLISTs if
required.
REXX Specifies that RECFM=VB, LRECL=255 REXX members be
converted to RECFM=FB, LRECL=80 REXX members using
REXX continuation rules.
MOVE Specifies that if no errors are detected during the copy
process, delete all of the copied members.
SUBSTITUTE Used with a forward slash (/) to represent the current data
(old,new) set name. Use SUBSTITUTE to replace a string of
characters in the source data set name to create a target
data set name.
For example, if the current data set is PDSEXXX.MSGS, the
following two subcommands are equivalent:
COPY ABC* PDSEYYYY.MSGS
COPY ABC* / SUBSTITUTE(XXX/YYYY)
FROMKEY(ky) For VSAM data sets only, code ky as the key of the first
record to be accessed. This is a generic key and can be
coded as x’hexkey’. Access begins at the first record whose
key matches (or is greater than) the portion of the key
specified.
Can be used with TOKEY. It can be specified only for an
alternate index or a key-sequenced data set.
FROMADDRESS(ad) For VSAM data sets only, code ad as 0 through 99999999
to specify the relative byte address (RBA) of the first record
to be accessed. The RBA value must match the beginning
of a logical record. If you specify this parameter for key-
sequenced data, the records are accessed in physical
sequential order instead of key order. Use this parameter
with TOADDRESS.
FROMADDRESS(address):
Can be coded only for key-sequenced, entry-sequenced or
linear data sets or DATA or INDEX components
Cannot be specified if the data set is being accessed through
a path
Cannot be specified for a key-sequenced data set with
spanned records if any of the spanned records are to be
accessed
FROMNUMBER(nm) For VSAM data sets only, code nm as 0 through 99999999
to specify the relative record number (RRN) of the first
record to be accessed. This record must be present in the
data set.
Use this parameter with TONUMBER. It can be specified
only for a variable or fixed relative record data set.
TOKEY(ky) For VSAM data sets only, code ky as the key of the last
record to be accessed. This is a generic key and can be
coded as x’hexkey’. Access ends after the first record
whose key matches the portion of the key specified.
Use this parameter with FROMKEY. It can be specified only
for an alternate index or a key-sequenced data set.
TOADDRESS(ad) For VSAM data sets only, code ad as 0 through 99999999
to specify the relative byte address (RBA) of the last record
to be accessed. The RBA value does need not to match the
beginning of a logical record. If you specify this parameter
for key-sequenced data, the records are accessed in
physical sequential order instead of key order. Use this
parameter with FROMADDRESS.
TOADDRESS(address):
Can be coded only for key-sequenced, entry-sequenced or
linear data sets or DATA or INDEX components
Cannot be specified if the data set is being accessed through
a path
Cannot be specified for a key-sequenced data set with
spanned records if any of the spanned records are to be
accessed
Required
memgroup, dsname or * or FILE(ddname)
Remarks
The COPY/DUP code switches dynamically to StarTool FDM internal copy routines if
requested for a given subcommand or if you require DUP internal support. COPY/DUP
switches to an internal copy routine for any of the following situations:
The DUP subcommand name initiates a copy
The input data set is VSAM or not partitioned
The output data set is not partitioned
An ADDZAP, CLIST, NOCLIST, NONUM, or SNUM keyword is used
Source data set and the MAXBLK keyword is used
Conversion of RECFM=FB to RECFM=VB or RECFM=VB to RECFM=FB.
Output records requiring truncation
RECFM=FB output records requiring blank padding at the end
Members are copied back into the source data set
For a PDSE data set, invoke the COPY subcommand to support the COMPRESS
subcommand using the COPYBACK keyword as follows:
Creates a new temporary PDSE similar to the source data set
Copies all members into the new temporary target data set
Resets the source PDSE to NEW status; deletes all members
Copies back all members into the source data set
IEBCOPY (or a compatible PDS copy program) performs the data copy operation. Internal
StarTool FDM routines are used instead if the input data set is sequential or a single
member is copied to a sequential output data set. In the following cases, an external copy
program such as IEBCOPY or PDSFAST is required:
Load library and the MAXBLK keyword is used
Load library and the BLKSIZE is more than output BLKSIZE
The new NODUP keyword is used
If the output data set is sequential and more than one input member is selected for copy,
the PDS copy program creates an output data set in IEBCOPY unload format.
If you use the TO (or the equivalent AS) keyword, each member is renamed in the copy in
a generic fashion. For example, if you enter TO(X12), each resulting member name is
formed by placing X12 over the first three characters of the original member name. An
exception to this rule is made when only a single member is to be copied and its aliases
are not also requested. In this case, the member name is taken directly from the TO
keyword.
If you do not specify the keywords EXIST, NOEXIST, EXCLUDE, or AS/TO and you enter
COPY : to copy all members, the normal IEBCOPY select statements are not generated.
However, if you want to build select statements for the entire library, specify a member
group name on the COPY subcommand which includes all members such as COPY :9.
Request an IEBCOPY COPY operation; however, if the data set contains load modules
(RECFM is U) and the input and output data set block sizes differ, a COPYMOD operation is
requested with a MAXBLK operand set to the output data set block size. Explicitly request
a COPYMOD operation for load module libraries by specifying MAXBLK and the desired
maximum member block size.
NOTE This subcommand modifies the output data set. To ensure data set integrity,
allocate the output data set as OLD or NEW, or be aware of the data set update
protection provided by the StarTool FDM command for SHR allocations. See Appendix B,
"Update Protection".
You may have chosen any one of several interfaces during StarTool FDM installation. To
determine which interface you chose, type a CONTROL DEFAULT subcommand and look
for an output line beginning COPY calls. For installations that use PDSFAST, also see the
COPY utility for program objects. The following are supported:
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------- ISPMODE Session Display ------------- ROW 387 OF 429
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.LIB.PDS98TST,VOL=SER=STR811 MEM=: ----------------------------
>----->copy :9 lib.test new
PDS174I 'C911407.LIB.TEST' has been created on volume STR801
COPY O=SYS00111,I=SYS00102
S M=@DIACLIK,@DIAINIT,@DIALOG,@DIAPANL,@DIAPART,@DIASTAK,@DIATBL
S M=@DIAWRK,ALIAS1,ALLGLOB,ASMEXT2,CHECKOUT,CICS,COMPARE,COMPARES
S M=COMPA1,COMPA2,COMPA3,DAFABC,DAFJCLO,DISAMSM,DISAMXM,DISASME
S M=DISASMX,DISASM3,DISDAFD,DISDAFE,MAPXREF,PDS99,PDS99T1D,TESTMSG
IEB167I FOLLOWING MEMBER(S) COPIED FROM INPUT DATA SET REFERENCED BY SYS0010
IEB154I @DIACLIK HAS BEEN SUCCESSFULLY COPIED
IEB154I @DIAINIT HAS BEEN SUCCESSFULLY COPIED
IEB154I @DIALOG HAS BEEN SUCCESSFULLY COPIED
IEB154I @DIAPANL HAS BEEN SUCCESSFULLY COPIED
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
----------------------------- ISPMODE Session Display ----------- ROW 31 OF 48
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.LINK.LOAD,VOL=SER=STR804 MEM=#* ------------------------------
>----->create link.test new tra spa(10,10) blk(6000)
PDS174I 'C911407.LINK.TEST' has been created on volume STR803
>----->copy * link.test
COPYMOD O=SYS00032,MAXBLK=06000,I=SYS00022
S M=#DISDF01,#DISXREF,#OPCODE,#OPCODEM,#OPCODE2,#PDSMAIN
IEB190I MAXIMUM BLOCK SIZE IS 6000, MINIMUM BLOCK SIZE IS 1024
IEB167I FOLLOWING MEMBER(S) COPIED FROM INPUT DATA SET REFERENCED BY SYS0002
IEB19AI MEMBER #DISDF01 COPIED AND REBLOCKED
IEB19AI MEMBER #DISXREF COPIED AND REBLOCKED
IEB19AI MEMBER #OPCODE COPIED AND REBLOCKED
IEB19AI MEMBER #OPCODEM COPIED AND REBLOCKED
IEB19AI MEMBER #OPCODE2 COPIED AND REBLOCKED
IEB19AI MEMBER #PDSMAIN COPIED AND REBLOCKED
IEB144I THERE ARE 0000001 UNUSED TRACKS IN OUTPUT DATA SET
IEB149I THERE ARE 0000079 UNUSED DIRECTORY BLOCKS IN OUTPUT DIRECTORY
IEB147I END OF JOB -00 WAS HIGHEST SEVERITY CODE
CREATE Subcommand
The CREATE subcommand allocates a new data set based on the current data set.
Example
CREATE new.data space(10,10)
Syntax
CREATE / or dataset
[BLKSIZE(Bval) ]
[DIR(num)/NODIR ]
[LRECL(Lval) ]
[OPTCD(W/WC/WCZ/C/CZ/Z) ]
[SPACE(nprim,nsec) ]
[BLK/TRK/CYL ]
[ROUND ]
[RETPD(nnnn)/EXPDT(yyddd) ]
[STORCLAS(sclass) ]
[MGMTCLAS(mclass) ]
[DATACLAS(dclass) ]
[DSNTYPE(LIBRARY/PDS) ]
[UNIT(Unitname) ]
[VOLUME(volser) ]
[SUBSTITUTE(oldstring/newstring)]
[RECFM(F/FB/FA/FM/FBA/FBM/V/VB/VA/VM/VBA/VBM/U/UA/U)]
Aliases
CR, CRE, CREA, CREAT, CREATE
Defaults
BLKSIZE, DIR, LRECL, OPTCD, SPACE, BLK/TRK/CYL, RECFM, ROUND, EXPDT/RETPD,
STORCLAS, MGMTCLAS, DATACLAS, and DSNTYPE as specified for the current data set.
Required
None
Operands
data set The new data set name. Use standard TSO dsname syntax.
BLKSIZE(Bval) A DCB BLKSIZE value for the new data set. Bval defaults to
its value for the current data set or can be entered as a
number from 0 through 32767.
DIR(num) The number of directory blocks for the output data set. If
you do not enter DIR, the default is taken from the current
data set.
NODIR Allocates the new data set as sequential regardless of the
current data set.
LRECL(Lval) A DCB LRECL value for the new data set. Lval defaults to its
value for the current data set or can be entered as a
number from 1 through 32767.
OPTCD(Newo) The desired OPTCD value for the data set. Newo defaults to
its value for the current data set or can be entered as W,
WC, WCZ, C, CZ, or Z.
SPACE(prim,sec) The primary and secondary space allocation quantities for
the new data set in block, track, or cylinder units.
If you do not enter BLK, TRK, or CYL but you do enter
SPACE, the space allocation units are assumed to be the
same as the current allocation.
BLK Allocates the output data set in blocks. If you enter BLK
without SPACE, the space allocation units are taken from
the current allocation and converted to equivalent block
units.
TRK Allocates the output data set in tracks. If you enter TRK
without SPACE, the space allocation units are taken from
the current allocation and converted to equivalent track
units.
CYL Allocates the output data set in cylinder units. If you enter
CYL without SPACE, the space allocation units are taken
from the current allocation and converted to equivalent
cylinder units.
ROUND Used with BLK to specify that the data set allocation be
rounded up to cylinder boundaries.
EXPDT(yyddd) The expiration date for the data set. On and after the
expiration date, delete or write over the data set. Also use
the form EXPDT(yyyyddd).
RETPD(nnnn) The number of days (0 to 9999) that the data set be
retained by your data center.
STORCLAS(sc) The storage class for the data set. Use this parameter to
identify performance and availability requirements for data
sets. Use this parameter instead of UNIT and VOLUME
keywords for SMS managed data sets to determine where
the data set is allocated. To nullify this parameter, type
STORCLAS(*).
MGMTCLAS(mc) The management class for the data set. This parameter
establishes the migration, backup and space release
characteristics for SMS managed data sets. To nullify this
parameter, type MGMTCLAS(*).
DATACLAS(dc) The data class for the data set. Use this parameter to
provide data attributes such as RECFM, KEYLEN, SPACE,
EXPDT or RETPD, DSORG, LRECL, and some VSAM SHR
options for SMS managed data sets. To nullify this
parameter, type DATACLAS(*). Use DATACLAS for data sets
that are not SMS managed.
DSNTYPE(typ) typ is specified as LIBRARY for a PDSE or PDS for a
partitioned data set. A PDSE must be a SMS managed data
set.
UNIT(Uname) The allocation unit name. Use this parameter if the default
unit name is incorrect for this allocation.
RECFM(Newr) A DCB RECFM value for the new data set. Newr defaults to
its value for the current data set or can be entered as F, FB,
FA, FBA, FM, FBM, V, VB, VA, VBA, VM, VBM, U, UA, or UM.
VOLUME(volser) The output volume name. Use this parameter if the data
set should be allocated on a particular volume. Use the
form VOLUME(*) if you want to make another allocation on
the same volume used for the current data set.
SUBSTITUTE(old,new) Used with a forward slash (/) to represent the current data
set name. Use SUBSTITUTE to replace a string of
characters in the source data set name to create a target
data set name.
For example, if the current data set is PDSEXXX.MSGS, the
following two subcommands are equivalent:
CREATE PDSEYYYY.MSGS
CREATE / SUBSTITUTE(XXX/YYYY)
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
----------------------------- ISPMODE Session Display --------- ROW 440 OF 446
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.LIB.TEST2,VOL=SER=STR815 MEM=: -------------------------------
>----->c lib.test
PDS200I DISP UNIT OPT RECFM LRECL BLKSIZE ALLOCTRK FREETRK SECONDARY FREEDIR
PDS200I SHR 3380 C FB 80 9040 3X 47 10 10 TRK 25
(Note: the parameters specified with the CREATE command will be determined by the
DFSMS environment, if one exists.)
CSECTS Function
The CSECTS command displays a map of a load module in an ISPF table.
Example
CSECTS idcams unres
Syntax
CSECTS member [UNRESOLVED]
Aliases
CS, CSE, CSEC, CSECT, CSECTS
Operands
member The member whose CSECTs and ENTRYs are to be mapped.
UNRESOLVED Adds unresolved and weak unresolved references to the map.
Remarks
The CSECTS ISPF table displays in response to a CSECTS or NUCMAP command. When
you are in a CSECTS display, delete a part of the table, sort the table in different
directions, find data in the table, print a part of the table or store a part of the table in a
data set, and so on. For help with the different options, use the HELP command, CUA
functions, or enter an O command as a primary command or as a line command.
The CSECTS table displays the names of all CSECTs and ENTRYs for a load module. Enter
line commands against CSECT table lines that apply only to that particular CSECT. The
screen fields for each line are as follows:
The following primary commands are supported directly for the CSECTS function. For
information on ISPMODE commands available anywhere in StarTool FDM, see “Common
Commands” in Chapter 2, "ISPF Interface Commands".
APP[LY] Applies the specified line command to all table entries and executes
each entry.
Syntax APPLY linecmd
O[PTIONS] Provides primary command selection for the CSECTS function and
operand syntax assistance.
OUT[PUT] Outputs the CSECTS table to print or a data set.
Syntax OUTPUT [=c / F(ddname)]
RF[IND] Finds a string (repeat find) and positions the display start location. PF
keys 5 and 17 are normally set to RFIND.
SO[RT] Sorts function tables into an alternate order. SORT with no operands
sorts the table in default order, while SORT with a field name sorts the
table in that order.
Syntax SORT [ADDRESS/NAME]
[ASCEND/DESCEND]
TAG Applies the specified line command to table entries marked with *TAG*
in the DATA/MSG field and executes each entry.
Syntax TAG linecmd
Block line commands are doubled letters that delimit a range of table entries for which the
same action is to be performed. The following block line commands are supported in the
CSECTS function:
== = command. Repeats the previous line command for the range of lines.
*cm ERR- t=”Block line command,==”>
LL LIST command. Lists data from each CSECT.
OO O command. Provides line command assistance for each line.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------- CSECT Display for STARTOOL ----------- ROW 1 OF 137
COMMAND ===> SCROLL ==> CSR
- DSN=SER07.LINK.LOAD,VOL=SER=SER002 MEM=STARTOOL ---------------------------
CMD TYPE DATA/MSG SECTION ENTRY -ADDR- -LENG- MD/SG MEM ADDR
WEAK-U VTSOCMD
WEAK-U PDS#OPT4
WEAK-U PDS#SECI
CSECT PDSMAIN 000000 002E4C A24
ENTRY PDSKLEAR 000138 A24
ENTRY PDSNCMD 0006D0 A24
ENTRY PDSSCAN4 000B06 A24
ENTRY PDSCONVD 0011DC A24
ENTRY PDSLDATA 00144A A24
ENTRY PDSOPENX 0020CC A24
ENTRY PDSRETUR 002320 A24
CSECT PDSPDSIN 002E50 000D9F A24
CSECT PDSATTNX 003BF0 00015E A24
CSECT PDSSTAEX 003D50 0002EA A24
CSECT PDSALLOC 004040 00087D A24
CSECT PDSEXCP 0048C0 000BDE A24
CSECT PDSMSGS 0054A0 003412 A24
CSECT *ENTRY PDSMAINA 0088B8 0001A0 A24
CSECT *ENTRY TESTAM64 000000 00004C RANY
DCF Subcommand
The DCF subcommand prints a hardcopy list of a member. Use the TSO SCRIPT command.
Add any SCRIPT operands after the member name.
Example
DCF mema:memb twopass index file(myfile)
Syntax
DCF memgroup
BIND(obind {ebind}) PAGE{({PROMPT}{{FROM} p {TO} q}
CHARS(font1..font4) {{FROM} p FOR n}{{FROM} p ON})}
CONTINUE/NOCONT PRINT{(copies,class,fcb,ucs)}
CTF PROFILE{(fileid)}/NOPROFILE
DDUT/NODDUT QUIET
DEST(station-id) SEARCH(libname)(opnum...)
DEVICE(devtype) SEGLIB/NOSEGLIB
FILE{(fileid)} SPELLCHK
FONTLIB({ftype}{fmodel}) STOP
FPASSES n SYON/SYOFF
INDEX SYSVAR(n value...)
LIB(libename...)(opnum...) TERM
MESSAGE({DELAY}{D}{TRACE}) TLIB
NOSPIE TWOPASS
NOWAIT UNFORMAT
NUMBER UPCASE
OPTIONS{(fileid)} @user-option
Aliases
DC, DCF
Defaults
memgroup
Required
none
Operands
The members to be printed. Default member names, member lists,
member name ranges, and member name patterns are allowed. For
memgroup more information, see Appendix A, "Formatting Member Names".
others Optional. May include any desired TSO SCRIPT operands.
Remarks
This interface is optional. Use it only if DCF Script is installed.
DDNAME Function
Use the DDNAME command to display a subset of your TSO session allocations in the
LISTA table. Maintain the DDNAME/LISTA table in DDNAME and concatenation order (the
SORT command is not supported).
Example
DDNAME isp*
Syntax
DDNAME namemask
Aliases
DD, DDN, DDNA, DDNAM, DDNAME
Defaults
none
Required
namemask
Operands
namemask This is a partial DDNAME that may contain masking characters (* for
combinations, / for patterns and : for ranges). For example,
ISP*LIB, PROC/SYS, and ISP:ISR.
Remarks
The DDNAME/LISTA ISPF table displays in response to a DDNAME command. When you
are in a DDNAME/LISTA display, delete a part of the table, find data in the table, print a
part of the table, store a part of the table in a data set, and so on. For help with the
different options available, use the HELP command, CUA functions, or enter an O
command as either a primary command or as a line command.
DDNAME has alternate panels, as do most of the ISPMODE tables in StarTool FDM, that
contain extra information about the listed data sets. The first DDNAME/LISTA panel shows
basic allocation information such as DDNAME, data set TYPE, Open count (under the
header O#), VOLUME allocated, MEMBER name, and DSNAME. Command error messages
are provided under the DATA/MSG header as follows:
TYPE is the data set DSORG or VIO, CTLG, VVDS, JES, or TERM depending on the type of
allocation.
The second DDNAME/LISTA panel is a double line panel that includes some additional
information: DISP for data set disposition and STAT for data set status. The STAT field is
TMP for temporary, PRM for permanent, or CNV for convertible.
The following primary commands are supported directly for the LISTA/DDNAME function.
For information on ISPMODE commands available anywhere in StarTool FDM, see
“Common Commands” in Chapter 2, "ISPF Interface Commands".
BAT[CHJCL] Builds batch JCL that includes all DD statements in the DDNAME
table.
COMPR[ESS] Global command. Changes to each data set in the table and issues a
COMPRESS subcommand.
Syntax COMPRESS [LIST/NOLIST/SUMMARY]
FI[ND] Global command. Changes to each data set in the table and issues a
FIND subcommand. Since the syntax entered on a FIND
subcommand is applied to each data set individually, do not attempt
to search mixed partitioned and non-partitioned data sets with a
single FIND global command.
Syntax FIND memgroup 'anystring'
[NUM/SNUM/NONUM/LBLOCK/LDUMP/BLOCK/DUMP]
[CAPS/ASIS/IGNORE] [WORD/PREFIX/SUFFIX]
GL[OBAL] Global command. Changes to each data set in the table and issues a
StarTool FDM subcommand.
Syntax GL anysubcommand [anyoperands]
MODEL Global command. Changes to each data set in the table and issues a
MODEL command.
NOR[MAL] Displays the default view of the LISTA/DDNAME table.
OUT[PUT] Outputs the LISTA/DDNAME table to print or to a data set.
Syntax OUTPUT [=c / F(ddname)]
REPL[ACE] Global command. Changes to each data set in the table and issues a
REPLACE subcommand. Since the syntax entered on a REPLACE
subcommand is applied to each data set individually, do not attempt
to update mixed partitioned and non-partitioned data sets with a
single REPLACE global command.
Syntax
REPLACE memgroup 'fromstring' 'tostring'
[NUM/SNUM/NONUM/LBLOCK/LDUMP/BLOCK/DUMP]
[CAPS/ASIS/IGNORE] [WORD/PREFIX/SUFFIX]
[WRITE/NOWRITE]
RESET Used with data set tagging, clears the DATA/MSG field in all table
entries.
RF[IND] Finds a string (repeat find) and positions the display start location.
PF keys 5 and 17 are normally set to RFIND.
RI[GHT] Rotates through alternate views of the LISTA/DDNAME table. PF keys
11 and 23 are normally set to RIGHT.
SEEK Global command. Changes to each data set in the table and looks for
a member.
Syntax SEEK member
TAG Applies the specified line command to table entries marked with
*TAG* in the DATA/MSG field and executes each entry.
Syntax TAG linecmd
Block line commands are doubled letters that delimit a range of table entries for which the
same action is to be performed. The following block line commands are supported in the
LISTA/DDNAME function:
== = command. Repeats the previous line command for the range of lines.
*cm ERR- t=”Block line command,==”>
FUNCTIONS CTL A-M CTL N-Z LINE CMDS A-M LINE CMDS N-Z DEFAULTS FEATURE
--------------------------- List Allocations ------------------ ROW 1 TO 7 OF 18
COMMAND ===> SCROLL ==> CSR
- DSN=C911407.LIB.ASM,VOL=SER=SER815 MEM=DAFX* -----------------------------
CMD DDNAME DATA/MSG I/O's O# VOLUME MEMBER ------ DATA SET NAME --------
ISPPLIB 177 1 SER006 SER07.LIB.PDSE
# 2 2 1 SER007 SER.COMPAREX.PANELS
# 3 0 1 TSG303 SYSI.IBMPDF.SYS350.PREPLIB
# 4 27 1 TSG302 SYSI.IBMPDF.SYS350.ISRENU
ISPMLIB 4 1 SER006 SER07.LIB.PDSE
# 2 0 1 SER007 SER.COMPAREX.MSGS
# 3 3 1 TSG302 SYSI.IBMPDF.SYS350.ISRENU
# 4 88 1 TSG309 SYSI.IBMPDF.SYS350.ISPENU
# 5 0 1 TSG301 SYSP.STD.ISPMLIB
ISPSLIB 0 1 TSG301 SYSP.STD.ISPSLIB
# 2 0 1 TSG302 SYSI.IBMPDF.SYS350.ISRENU
ut ISPTLIB 1 1 TSG301 SYSP.STD.ISPTLIB
# 2 0 1 TSG309 SYSI.IBMPDF.SYS350.ISRLIB
ISPPROF 22 1 SYSR2C SER07.ISPF.PROFILE
ISP05482 8 1 SER004 SER07.SPFLOG2.LIST
DECODE Subcommand
The DECODE subcommand decrypts a member. This was written using the data
encryption algorithm submitted by IBM to the National Bureau of Standards and published
in the Federal Register.
Example
DECODE mymember plaintxt keyexamp
Syntax
DECODE input output key [SHR|OLD]
Aliases
DEC, DECO, DECOD, DECODE
Defaults
OLD
Required
input, output, key
Operands
input Identifies the member to be decoded.
If this is a 1- to 8-byte simple name, it is taken to be a member name in the
current data set; otherwise, it is taken to be data.set(member).
output Identifies the receiving member.
If this is a 1- to 8-byte simple name, it is taken to be a member name in the
current data set; otherwise, it is taken to be data.set(member).
key This is a 1- to 8-byte alphanumeric key to be used for decoding the data set
member.
OLD This allocation is not to be shared with any other allocation for this data set.
SHR This allocation is to be shared with other allocations for this data set.
Remarks
This subcommand decrypts data using the supplied translation key. Since this algorithm
works on eight bytes at a time, the actual number of bytes enciphered or deciphered is an
integral number of eight bytes that is less than or equal to the record length. The greatest
number of bytes left unchanged on a record are the right-most seven bytes.
NOTE This method does not record your key. If you cannot provide the key, the data is
not readable. Use the DECODE load module independently of StarTool FDM. A HELP entry
is available but the basic syntax is as follows:
DELETE Subcommand
The DELETE (or SCRATCH) subcommand deletes a member from the data set. If you
delete a member group, the members are deleted in reverse member group order to
optimize directory operations.
If you are planning to delete members in a LLA controlled library, see “LLA and Deleted
Members” in Chapter 6, "Commands — L to N".
Example
DELETE mema:memb
Syntax
DELETE memgroup [ALIAS/NOALIAS] [FORCE]
Aliases
DEL, DELE, DELET, DELETE, SCRA, SCRAT, SCRATC, SCRATCH
Defaults
memgroup, NOALIAS
Required
none
Operands
memgroup Identifies the members to be deleted.
Default member names, member lists, member name ranges, and
member name patterns are allowed. For more information, see Appendix
A, "Formatting Member Names".
ALIAS Deletes any associated members (aliases, apparent aliases, and
associated main members).
NOALIAS Deletes only the members specifically identified.
FORCE Deletes even if an edit session is currently using the member.
Remarks
NOTE This subcommand modifies the data set. To ensure data set integrity, allocate the
data set as OLD or be aware of the data set update protection provided by the StarTool
FDM command for SHR allocations. For details, see Appendix B, "Update Protection".
DELINK Subcommand
The DELINK subcommand reconstructs object code from a load module.
Example
DELINK mymemb
Syntax
DELINK memgroup [MODULE({* / Fullm / Partm*)} ]
Aliases
DELI, DELIN, DELINK
Defaults
memgroup
Required
none
Operands
memgroup Identifies the members to be decoded to object code.
Default member names, member lists, member name ranges,
and member name patterns are allowed. For more information,
see Appendix A, "Formatting Member Names" on page 417.
MODULE(name) Specifies a 1- to 8-byte partial external name that limits CSECT
or ENTRY names to be considered.
The MODULE operand has several valid forms:
MODULE(*) – uses the previous name entered on any MODULE
keyword
MODULE(Fullm) – decodes only a CSECT or ENTRY named FULLM
MODULE(Partm*) – decodes only a CSECT or ENTRY named PARTM
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------- ISPMODE Session Display ----------------- ROW 1 OF 354
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.LINK.LOAD,VOL=SER=SER002 MEM=VTOC ------------------------------
>----->delink vtoc
//VTOC EXEC PGM=IEWL,
// PARM='NCAL,MAP,LIST,LET,RENT,REUS,REFR'
//SYSUT1 DD UNIT=SYSDA,SPACE=(1024,(200,20))
//SYSPRINT DD SYSOUT=*
//SYSLMOD DD DISP=SHR,DSN=SER07.LINK.LOAD
//SYSLIBX DD *
ESD VTOCCMD VTOCMSG VTOCEXCP
ESD VTOCSORT PCLMAIN
TXT 00 VTOCCMD ...
DIRENTRY Subcommand
The DIRENTRY subcommand displays a member’s directory entry.
Example
DIRENTRY mema:memb
Syntax
DIRENTRY memgroup [SHORT/LONG]
Aliases
DIR, DIRE, DIREN, DIRENT, DIRENTR, DIRENTRY
Defaults
memgroup, SHORT for THEN(DIR) or ELSE(DIR); otherwise, LONG
Required
none
Operands
memgroup Identifies the members whose directory entry is to be displayed.
Default member names, member lists, member name ranges, and
member name patterns are allowed. For more information, see Appendix
A, "Formatting Member Names" on page 417.
DISASM Subcommand
The DISASM subcommand reconstructs assembler language instructions from a module.
This procedure is often referred to as decoding or disassembling instructions.
Example
DISASM mymemb OFFSET(1af2)
Syntax
DISASM memgroup [FLOAT|NOFLOAT ]
[MODULE({*|fullname|partm*})]
[OFFSET(hexnum)]
[MVS370|MVSXA|ESA370]
[PRIV|NOPRIV]
[REASM]
Aliases
DISA, DISAS
Defaults
memgroup, NOFLOAT, NOPRIV, ESA370
Required
None
Operands
memgroup Identifies the members to be disassembled.
Default member names, member lists, member name ranges,
and member name patterns are allowed. For more information,
see Appendix A, "Formatting Member Names".
FLOAT Includes floating-point instructions in the instruction set.
NOFLOAT Does not decode floating-point instructions.
MODULE(name) Specifies a 1- to 8-byte partial external name that limits CSECT
or ENTRY names to be displayed.
If you enter both MODULE and OFFSET keywords, the offset
applies to each module selected. The MODULE operand has
several valid forms:
MODULE(*) – uses the previous name entered on any MODULE
keyword
MODULE(Fullm) – formats only a CSECT or ENTRY named FULLM
MODULE(Partm*) – formats only a CSECT or ENTRY named PARTM
OFFSET(Hx) Specifies a 1- to 6-digit hexadecimal module offset at which the
display is to begin. If you enter both MODULE and OFFSET
keywords, the offset applies to each module selected.
MVSXA Uses only instructions defined on MVS/XA systems.
ESA370 Uses only instructions defined on MVS/ESA systems. This
instruction set also includes all MVS/XA instructions.
PRIV Includes privileged instructions in the instruction set.
NOPRIV Does not decode privileged instructions.
REASM Outputs the disassembled instructions in a format that can be
submitted to recreate the decoded module. When you request
this format, the module offset field and the CSECT offset field
(the first two fields of output) are reversed in order and placed at
the end of each decoded statement.
PDS141I header messages are suppressed and JCL is created to
assemble and link the decoded module and its aliases.
Remarks
For program objects, the DISASM command will only produce output for sections that are
B_TEXT.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
-------------------------- ISPMODE Session Display ---------- ROW 8936 OF 10720
COMMAND ===> ===> CSR
- DSN=C911407.LINK.LOAD,VOL=SER=STR804 MEM=ZAPHELP -------------------------
>----->disasm zaphelp off(40c0)
PDS141I AT 003FF0 CSECT CSOUT LENGTH 000428
0040C0 00D0 BAL R15,228(,R12) 45F0 C0E4 *.0U*
0040C4 00D4 DC AL4(A0040CC) 000040CC *.. .*
0040C8 00D8 DC X'00000000' 00000000 *....*
0040CC 00DC A0040CC DC C'IKJDAIR ' C9D2D1C4C1C9D940 *IKJDAIR*
0040D4 00E4 SVC 6 LINK 0A06 *..*
0040D6 00E6 BXH R15,R15,58(R12) 86FF C03A *f..*
0040DA 00EA MVC 144(8,R10),416(R13) D207 A090 D1A0 *K...J.*
0040E0 00F0 XC 16(4,R10),16(R10) D703 A010 A010 *P.....*
0040E6 00F6 LA R0,48(,R10) 4100 A030 *....*
0040EA 00FA ST R0,8(,R10) 5000 A008 *&...*
0040EE 00FE MVI 8(R10),X'8F' 928F A008 *k...*
0040F2 0102 MVC 48(96,R10),936(R12) D25F A030 C3A8 *Kª..Cy*
0040F8 0108 MVC 88(8,R10),144(R10) D207 A058 A090 *K.....*
0040FE 010E LA R1,8(,R10) 4110 A008 *....*
004102 0112 SVC 19 OPEN 0A13 *..*
DISPLAY Subcommand
The DISPLAY subcommand lists member names from the data set directory. The default
member group is not affected by the DISPLAY or PATTERN subcommands.
Example
DISPLAY aa b4
Syntax
DISPLAY name1 name2
Aliases
D, DI, DIS, DISP, DISPL, DISPLA, DISPLAY
Defaults
entire directory
Required
none
Operands
name1 The starting member name (or portion of the member name) at which the
display is to start. If omitted, the entire directory displays. Enter a group
name descriptor such as part1:part2, seg1/seg2, or part1*seg1 for name1,
in which case, the output consists of the member names that are displayed
by the MEMBERS subcommand.
name2 Specifies the ending member name (or portion of the member name) after
which the display is to stop. If omitted, the display continues to the end of
the directory.
Remarks
Neither DISPLAY nor PATTERN affect the current member group. If you enter DISPLAY
without operands, all members in the data set display. This differs from PATTERN in that
PATTERN remembers its previously entered operands.
-A is added following a displayed member name if the member name is an alias. The
member name is listed in a combined hexadecimal/character format if it does not contain
upper-case alphanumeric characters (including @, $, and #) or if the first character is
numeric. Unprintable characters (for 3270-type devices) in a member name display as
periods.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------- ISPMODE Session Display ---------------- ROW 518 OF 520
COMMAND ===> OLL ===> CSR
- DSN=C911407.LIB.TEST,VOL=SER=STR815 MEM=(PDSR ----------------------------
>----->d @*
@DIACLIK @DIAINIT @DIALOG @DIAPANL @DIAPART @DIASTAK
@DIATBL @DIAWRK
>----->d @:d
@DIACLIK @DIAINIT @DIALOG @DIAPANL @DIAPART @DIASTAK
@DIATBL @DIAWRK ALIAS1 -A ALLGLOB ASMEXT2 CHECKOUT
CICS COMPARE COMPARES COMPA1 COMPA2 COMPA3
DISASM3 DISDAFD DISDAFE
DSAT Subcommand
This interface is optional, and is used only if your installation installed the public domain
DSAT command. For current information on the DSAT command, refer to the CBT Web site
at http://www.cbttape.org/, file 112.
Use the DSAT subcommand to display allocation information for data sets on a direct
access device.
DSAT searches the catalog for the entries for the data sets specified. Allocation
information is obtained from the volume table of contents, formatted and displayed. If a
name is an index name, all data sets below the index display.
Bypass the catalog search by supplying the volume name on which the data set resides.
This option permits displaying information for uncataloged data sets.
Example
DSAT lib
Syntax
DSAT [(dsnamelist)] [ALL/DAONLY ]
[ALLOC/NOALLOC ]
[CCHHR/NOCCHHR ]
[CRDATE/NOCRDATE ]
[DCB/NODCB ]
[DEVICE/NODEVICE ]
[DEVTYPE/NODEVTYPE ]
[DSORG/NODSORG ]
[EXDATE/NOEXDATE ]
[GDGDATA/NOGDGDATA ]
[GENERIC/DSONLY ]
[HARDCOPY(ddname) ]
[HEADER/NOHEADER ]
[LASTREF/NOLASTREF ]
[PDS/NOPDS ]
[PRINT/NOPRINT ]
[RC(TALLOC/TUSED/TDIFF/ ]
LALLOC/LUSED/LDIFF/NUM/ ]
PREVIOUS/DSORG/DIRALLOC/ ]
DIRUSED/ENTRIES/ALIASES/MEMBERS) ]
[SECONDARY/NOSECONDARY ]
[SEQNO/NOSEQNO ]
[SERIAL/NOSERIAL ]
[TOTALS/NOTOTALS ]
[VOLUME(name) ]
Aliases
DSA, DSAT
Defaults
dsnamelist defaults to ‘prefix’ to list a user’s data sets; see underscores above.
Required
none
Operands
dsnamelist One or more data set or index level names. Use TSO naming
conventions. If a specified name is an index name, data sets
under that level display. If you do not specify name, the prefix is
used. If no name is specified and the profile specifies NOPREFIX,
the user ID is used.
If you enter a keyword, you must specify dsnamelist. If you omit
dsnamelist, it does not default to the prefix, but the keyword is
interpreted as the dsnamelist, not a keyword.
ALL Displays all data set names under an index level.
DAONLY Displays data sets on mounted direct access devices.
ALLOC Lists allocation information (tracks allocated, tracks free, and
extents).
NOALLOC Does not list allocation information.
CCHHR Displays Format 1 DSCB address.
NOCCHHR Does not display CCHHR.
CRDATE Lists creation date.
NOCRDATE Does not list creation date.
DCB Lists DCB information (RECFM, BLKSIZE, and LRECL).
NODCB Does not list DCB information.
DEVTYPE Displays device type code (for example, 3010200F for a 3390).
NODEVTYPE Does not display device type code.
DEVICE Lists device name (3380, 9345, etc.).
NODEVICE Does not list device name.
DSORG Lists data set organization.
NODSORG Does not list data set organization.
EXDATE Lists expiration date.
NOEXDATE Does not list expiration date.
GDGDATA Displays information on generation data group indexes.
NOGDGDATA Does not display information on generation data group indexes.
GENERIC Name specifies a generic key.
DSONLY Treats names as data set names, not index names.
HARDCOPY(dd) Specifies the DDNAME of a pre-allocated data set for output from
DSAT.
HEADER Displays an output header line.
NOHEADER Does not display a header line.
LASTREF Displays last date referenced.
NOLASTREF Does not display last date referenced.
PDS Lists PDS directory information (blocks alloc, used, entries, and
aliases).
NOPDS Does not list PDS directory information.
PRINT Output is to be displayed.
NOPRINT Output is not to be displayed, except for error messages.
RC(type) How the return code is to be set.
If you use DSAT as a StarTool FDM subcommand, return code
processing is not performed (the return code is set to zero). If
you use DSAT in a CLIST or REXX exec or in single subcommand
mode as in the following example, the return code is set
properly:
STARTOOL FILE(ISPPROF) DSAT LIB
RC(TALLOC)
If you do not specify RC, RC=4 means successful completion and
RC=16 means unable to interpret command. Otherwise, RC is
set to a value as specified by:
TALLOC - total tracks allocated
TUSED - total tracks used
TDIFF - total over-allocation (TALLOC minus TUSED)
LALLOC - tracks allocated by last data set
LUSED - tracks used by last data set
LDIFF - last data set over-allocation (LALLOC minus LUSED)
NUM - number of data sets displayed (including data sets not
found)
PREVIOUS - assumes the return code of the previous command
DSORG - sets the return code based on the data set organization
of the data sets displayed as:
All data sets were sequential
All data sets were PDS
Data sets were mixed PDS and sequential
Data set other than PDS or sequential or an error
DIRALLOC - number of directory blocks allocated
DIRUSED - number of directory blocks used
ENTRIES - number of entries in the directory (members and
aliases)
ALIASES - number of alias entries
MEMBERS - number of entries less the number of aliases
SECONDARY Displays secondary allocation information.
Remarks
Use DSAT in CLISTs to find the allocation of a data set or a group of data sets and set the
return code to the specified value. Test the return code with the WHEN command.
Suppress output by specifying NOPRINT. Use the HARDCOPY keyword to direct the output
to a pre-allocated data set.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
--------------------- ISPMODE Session# 1 Log# 1 ------------ ROW 61 TO 77 OF 77
COMMAND ===> L ===> CSR
- DSN=SER07.LIB.CNTL,VOL=SER=SER006 MEM=(BATDELAY --------------------------
>----->dsat lib
SERIAL ALLOC FREE EX DSORG -DCB ATTRIBUTES- CR. DATE -DSNAME-
SER006 379 0 2 A-PO FB 13680 80 03/05/93 SER07.LIB.ASM
SER007 140 97 4 A-PO FB 9040 80 10/04/89 SER07.LIB.CLIST
SER006 4 2 3 A-PO VB 32760 255 03/15/91 SER07.LIB.CLISTV
SER006 100 15 1 A-PO FB 13680 80 03/17/93 SER07.LIB.CNTL
SER006 1 0 1 A-PO FB 9040 80 07/17/92 SER07.LIB.EXPDT
SER007 25 0 1 A-PO FB 9040 80 10/04/89 SER07.LIB.FILE112
SER007 63 0 1 A-PO FB 9040 80 10/04/89 SER07.LIB.FILE296
SER007 203 0 2 A-PO U 32000 0 10/04/89 SER07.LIB.LOAD
SER006 765 225 3 A-PO FB 13680 80 05/06/93 SER07.LIB.PDSE
SER006 459 0 1 A-PO FB 13680 80 05/06/93 SER07.LIB.PDSE311
SER006 180 0 2 A-PO FB 13680 80 06/29/93 SER07.LIB.PDSE320
SER007 4 0 1 A-PO FB 9040 80 09/21/92 SER07.LIB.PDSINSTL
SER007 2 0 1 A-PO U 13030 0 07/09/93 SER07.LIB.STOW
SER007 10 9 1 A-PS FB 2000 200 06/30/93 SER07.LIB.TESTVSAM
2335 348 14 DATA SETS DISPLAYED
******************************* BOTTOM OF DATA *******************************
DSNAME Subcommand
The DSNAME subcommand displays statistics on the current data set allocation using
message format PDS200I, PDS210I, or PDS220I depending on the last DSNAME operand
(MSG, TSO, or JCL) entered.
Example
DSN
Syntax
DSNAME [MSG / TSO / JCL]
Aliases
DS, DSN, DSNA, DSNAM, DSNAME, DSNAMES
Defaults
Initially MSG; thereafter, previous MSG/TSO/JCL
Required
none
Operands
MSG Uses the PDS200I message (table or msg format) for allocation display.
TABLE Uses the PDS200I message (table or msg format) for allocation display.
TSO Uses the PDS210I message (TSO format) for allocation display.
JCL Uses the PDS220I message (JCL or batch format) for allocation display.
BATCH Uses the PDS220I message (JCL or batch format) for allocation display.
>----->dsn tbl
PDS200I DISP UNIT OPT RECFM LRECL BLKSIZE ALLOCTRK FREETRK SECONDARY FREEDIR
PDS200I SHR 3380 C FB 80 9040 1X 47 10 40 TRK 25
>----->dsn tso
PDS210I ALLOC F(SYS00134) DA('C911407.LIB.TEST') SHR UNIT(3380) -
PDS210I RECFM(F B) LRECL(80) BLKSIZE(9040) OPTCD(C) VOLUME(STR815) -
PDS210I TRK SPACE(47,40) DIR(30) /*FREE TRK=10,FREE DIR=25*/
DUP Subcommand
The DUP subcommand copies members to another data set. It is in the COPY
subcommand and performs the copy with internal routines. Use the COPY subcommand
without concern for using DUP since DUP routines are used as needed.
Copying members between unlike data sets is supported; however, load members can
only be copied to load libraries. Records are truncated or padded with blanks during the
copy as required.
If the source data set is RECFM=F with LRECL=80 and the target data set is RECFM=V
with LRECL=255 (or the reverse), DUP supports CLIST conversion during the copy. CLIST
conversion involves assigning new sequence numbers at the beginning or end of each
output line. For converting from RECFM=V to RECFM=F, DUP breaks lines up as required
to fit in 80-character lines using a - as a continuation character.
If the data set to be copied contains load modules (RECFM is U) and the output block size
is smaller than the input block size, DUP does not copy the data set since a COPYMOD
function is required. In this case, use the COPY subcommand. COPY automatically
requests a COPYMOD function because of the differences in block sizes.
Example
DUP mem1:mem2 other.dataset shr
Syntax
DUP memgroup
{/ or dsname [VOLUME(volser)] / * / FILE(ddname) [NUMBER(numb)]}
[OLD/SHR / NEW [BLK/TRK/CYL] [DIR(num)] [SPACE sec)]]
[ROUND] [EXPDT(yyddd)/RETPD(nnnn)] [RLSE]
[STORCLAS(sclass)] [MGMTCLAS(mclass)]
[DATACLAS(dclass)] [DSNTYPE(LIBRARY/PDS)]
[UNCTLG/NOCATLG]
[ALIAS/NOALIAS ]
[CHANGE/GO ]
[ADDZAP/ADDZAP(numb) ]
[NONUM/SNUM ]
[NOCLIST ]
[REXX ]
[AS(pname) / TO(pname) ]
[CALL/NOCALL ]
[EXIST/NOEXIST/EXCLUDE/NOBLDL ]
[MAXBLK(num) ]
[REPLACE/NOREPLACE ]
[SUMMARY/LIST/NOLIST ]
[UNIT(Unitname) ]
[CHANGE/GO ]
[MOVE ]
[SUBSTITUTE(oldstring,newstring)]
[VOLUME(volser) ]
* [FROMKEY(key)/FROMADDRESS(add)/FROMNUMBER(num) ]
* [TOKEY(key)/TOADDRESS(add)/TONUMBER(num) ]
*NOTE: Lines with an asterisk are supported for VSAM only.
Aliases
DU, DUP
Abbreviations
FKEY for FROMKEY, FADDR for FROMADDRESS, FNUM for FROMNUMBER, TKEY for TOKEY,
TADDR for TOADDRESS, and TNUM for TONUMBER.
Defaults
ALIAS if load, NOALIAS otherwise; SHR, NOREPLACE, MAXBLK(output BLKSIZE). If NEW
is specified, BLK/TRK/CYL, DIR, SPACE, ROUND, EXPDT, STORCLAS, MGMTCLAS,
DATACLAS, and DSNTYPE default to values used for the input data set.
Required
memgroup, dsname / FILE(ddname)
Operands
memgroup The members to be copied to the target data set.
Default member names, member lists, member name
ranges, and member name patterns are allowed. See
Appendix A, "Formatting Member Names".
dsname The output data set. Use standard TSO dsname syntax or a
temporary data set name such as &&TEMP. Only sequential,
direct or partitioned output data sets are supported by DUP.
As an alternative to the AS or TO keywords, enter partial
member names in parentheses following the data set name,
such as:
the.dsn(pname)
FILE(ddname) The output data set is allocated with the provided DDNAME.
Only disk data sets are supported. They must be sequential
or partitioned.
NUMBER(numb) The concatenation number for the DDNAME identified. numb
defaults to 1. If numb is larger than the number of
concatenated data sets, the last data set in the
concatenation sequence is used.
OLD Obtains exclusive use of the output data set.
SHR Allows shared use of the output data set. StarTool FDM
provides output data set protection. See Appendix B,
"Update Protection".
CHANGE Specifies that StarTool FDM should CHANGE to the output
data set at the end of the DUP process.
GO Specifies that StarTool FDM should initiate a GO session for
the output data set at the end of the DUP process.
ALIAS Copies any associated members (aliases, apparent aliases,
and associated main members).
NOALIAS Copies only the members specifically identified.
AS(pname) pname defines the name of any output members. For
example, with AS(new) and the input members AA, ABBA,
and IBM04, members named NEW, NEWA, and NEW04 are
created. AS and TO are equivalent keywords.
If only a single member is input and NOALIAS is in effect,
the resulting member name is taken only from the AS or TO
keyword.
TO(pname) pname defines the name of any output members. For
example, with TO(new) and the input members AA, ABBA,
and IBM04, members named NEW, NEWA, and NEW04 are
created. TO and AS are equivalent keywords.
If only a single member is input and NOALIAS is in effect,
the resulting member name is taken only from the AS or TO
keyword.
REPLACE Replaces members in the output data set by any copied
members.
NOREPLACE Does not replace members in the output data set by copied
members.
ADDZAP For load members only, specifies that a ZAP IDR record is to
be added (each ZAP IDR record contains space for 19
historical entries).
ADDZAP(numb) For load members only, add 1 to 99 ZAP IDR records.
MAXBLK(nm) For source members only, nm specifies the maximum
output block size to be used when the members are
reconstructed.
NONUM For source members only, specifies that the input members
are all data and no sequence numbers are to be formatted.
This keyword is ignored on a RECFM=F to RECFM=V CLIST
conversion.
SNUM For source members only, specifies that sequence numbers
in the input (the first 8 columns for RECFM=V data sets;
otherwise the last 8 columns) are to be discarded during the
copy.
NOCLIST CLIST conversion is not to be performed. Perform CLIST
conversion if RECFM=V, LRECL=255 data is copied to
RECFM=F, LRECL=80 or the reverse. CLIST conversion
entails assigning new sequence numbers and breaking up
long lines into several short ones while maintaining CLIST
format rules.
REXX Specifies that RECFM=VB, LRECL=255 REXX members be
converted to RECFM=F, LRECL=80 REXX members using
REXX continuation rules.
This algorithm works for many REXX routines but it is not
error-free because this subcommand is not aware of text
strings delimited by “or”.
UNIT(uname) The allocation unit name. Use this parameter if the default
unit name is incorrect for this allocation.
NEW Creates the output data set. When you specify NEW, also
specify BLK/TRK/CYL, DIR, SPACE, ROUND, EXPDT (or
RETPD), RLSE, STORCLAS, MGMTCLAS, DATACLAS, and
DSNTYPE keywords.
VOLUME(volser) For NEW data sets, specifies the output volume name. For
existing data sets, Use this parameter if the output data set
is not cataloged. For new data sets, code VOLUME(*) to
mean the volume parameter is to be copied.
DIR(num) The number of directory blocks for the output data set. If
you do not enter DIR, the default is taken from the input
data set.
SPACE(prim,sec) The primary and secondary quantities for the output data
set in track or cylinder units.
If you do not enter BLK, TRK, or CYL but you enter SPACE,
the space allocation units are assumed to be the same as
the current allocation.
BLK Allocates the output data set in blocks. If you enter BLK
without SPACE, the space allocation units are taken from
the current allocation and converted to equivalent block
units.
TRK Allocates the output data set in tracks. If you enter TRK
without SPACE, the space allocation units are taken from
the current allocation and converted to equivalent track
units.
CYL Allocates the output data set in cylinder units. If you enter
CYL without SPACE, the space allocation units are taken
from the current allocation and converted to equivalent
cylinder units.
ROUND Used with BLK to specify that the data set allocation be
rounded up to cylinder boundaries.
EXPDT(yyddd) The expiration date for the data set. On and after the
expiration date, delete or write over the data set. Also use
the format EXPDT(yyyyddd).
RETPD(nnnn) The number of days (0 to 9999) that the data set be
retained by your data center.
RLSE Any unused space in the data set is to be released after the
copy operation.
STORCLAS(sc) The storage class for the data set. Use this parameter to
identify performance and availability requirements for data
sets. Use this parameter instead of UNIT and VOLUME
keywords for SMS-managed data sets to determine where
the data set is allocated. To nullify this parameter, enter
STORCLAS(*).
MGMTCLAS(mc) The management class for the data set. This parameter
establishes the migration, backup, and space release
characteristics for SMS-managed data sets. To nullify this
parameter, enter MGMTCLAS(*).
DATACLAS(dc) The data class for the data set. Use this parameter to
provide data attributes such as RECFM, KEYLEN, SPACE,
EXPDT or RETPD, DSORG, LRECL, and some VSAM SHR
options for SMS-managed data sets. To nullify this
parameter, enter DATACLAS(*). Use DATACLAS for data
sets that are not SMS-managed.
DSNTYPE(typ) Specify typ as LIBRARY for a PDSE or PDS for a partitioned
data set. A PDSE must be a SMS-managed data set.
UNCATLG Does not catalog the NEW data set.
NOCATLG Does not catalog the NEW data set.
CALL Calls the copy program to perform the copy.
NOCALL Does not call the copy program. Member checking, control
card generation, and data set allocations are performed.
EXIST Copies only the subset of memgroup that is also present in
the output data set (the REPLACE keyword is also used).
NOEXIST Copies only the subset of memgroup that is not present in
the output data set.
NOBLDL Does not perform BLDL (member existence) checking in the
target library. Uses this parameter when performance of the
COPY subcommand is very important and BLDL checking
(by StarTool FDM) for possible errors is not important.
SUMMARY Displays only copy summary and error messages.
Remarks
If you use the TO (or the equivalent AS) keyword, each member is renamed in the copy in
a generic fashion. For example, if you enter TO(X12), each resulting member name is
formed by placing X12 over the first three characters of the original member name. An
exception to this rule is made when only a single member is to be copied and its aliases
are not also requested. In this case, the member name is taken directly from the TO
keyword.
For load members, add a null ZAP IDR record as the member is being copied. For non-load
members, the output member is reblocked to the receiving data set’s BLKSIZE or the
MAXBLK specified.
NOTE This subcommand modifies the output data set. To ensure data set integrity,
allocate the output data set as OLD, or be aware of the data set update protection
provided by the StarTool FDM command for SHR allocations. For details, see Appendix B,
"Update Protection" on page 421.
DVOL Subcommand
This interface is optional. Use it only if your installation installed the public domain DVOL
command. For information on the DVOL command, refer to the CBT Web site at http://
www.cbttape.org/, file 112.
Use the DVOL subcommand to display the amount of free space on a direct access device.
Example
DVOL tso long
Syntax
DVOL [(volumelist)/* ] [SHORT/LONG ]
[HEADER/NOHEADER ]
[PRINT/NOPRINT ]
[SERONLY ]
[HARDCOPY(ddname) ]
Aliases
DV, DVO, DVOL
Defaults
Use an * to display all volumes, SHORT, HEADER, and PRINT. If HARDCOPY is specified,
NOPRINT is the default.
Required
none
Operands
volumelist A list of one or more volume names of mounted direct access
volumes or partial volume names.
If you do not enter a volume, or if you specify an *, the information
displays for each direct access volume on the system.
If you enter a volume name with a U followed by 1 to 3 digits, the
data is used as a UCB name.
SHORT Displays short form output.
LONG Displays long form output.
HEADER Displays a short form header.
NOHEADER Displays no short form header.
PRINT Displays output.
NOPRINT Displays no output.
SERONLY Displays only a list of mounted volumes.
HARDCOPY(dd) Specifies the DDNAME of a pre-allocated data set to receive a copy
of DVOL output.
Remarks
DVOL reads the Format 4 and Format 5 DISCOs from the VTOC of a direct access volume
and displays:
Volume name
Unit address
Device type including density indicators
Mount status and use status
Number of blank DISCOs in the VTOC
The Return code is set to the total number of tracks in the 5 largest extents (to a
maximum of 4095) for the last volume displayed.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------ ISPMODE Session# 1 Log# 1 ------------ ROW 46 TO 60 OF 60
COMMAND ===> OLL ===> CSR
- DSN=SER07.LIB.CNTL,VOL=SER=SER006 MEM=(BATDELAY --------------------------
>----->dvol abc
SERIAL --UNIT-- ATTRIBUTES VSAM AVAIL -----TOTALS---- LARGEST-EXTENT 5 EXTS
ADR TYPE MOUNT/USE DSCBS TRACKS EXT CYL CYL+TR TRACKS TRACKS
ABC522 522 3380E RESDNT/PRIV OFF 791 13247 3 881 442+14 6644 13247
ABCD4B 531 3390M3 RESDNT/PRIV OFF 753 9538 14 632 422+ 0 6330 9399
EDIT Subcommand
The EDIT or SPFEDIT subcommand enters ISPF edit for a member.
Example
EDIT mema:memb
Syntax
EDIT memgroup [OLD/NEW ]
[MACRO(macname) ]
[SM(macname)/SETMACRO(macname) ]
[PROFILE(profname) ]
[SP(profname)/SETPROF(profname)]
[CONFIRM/NOCONFIRM ]
[SETCONFIRM/NOSETCONFIRM ]
* [FROMKEY(key)/FROMADDRESS(add)/FROMNUMBER(num) ]
* [TOKEY(key)/TOADDRESS(add)/TONUMBER(num) ]
*NOTE: Lines with an asterisk are supported for VSAM with PEDIT or EDIF.
Aliases
E, ED, EDI, EDIT, S, SP, SPF, SPFE, SPFED, SPFEDI, SPFEDIT
Abbreviations
FKEY for FROMKEY, FADDR for FROMADDRESS, FNUM for FROMNUMBER, TKEY for TOKEY,
TADDR for TOADDRESS, and TNUM for TONUMBER.
Defaults
memgroup, confirm
Required
none
Operands
memgroup The source members to be edited.
Default member names, member lists, member name ranges,
and member name patterns are allowed. For more
information, see Appendix A, "Formatting Member Names".
OLD Verifies that the member exists before invoking ISPF EDIT
service.
NEW Verifies that the member does not exist before invoking ISPF
EDIT service.
MACRO(mac) An initial edit macro name.
SM(mac) A default initial edit macro name. To nullify this parameter,
enter SM(*).
SETMACRO(mac) A default initial edit macro name. To nullify this parameter,
enter SETMACRO(*).
PROFILE(prof) The edit profile name (the supplied name is used instead of
the low-level DSNAME qualifier).
SP(prof) A default edit profile name. To nullify this parameter, enter
SP(*).
SETPROF(prof) A default edit profile name. To nullify this parameter, enter
SETPROF(*).
CONFIRM For ISPF 4.x, specifies that you desire prompting for MOVE,
REPLACE, or CANCEL operations.
NOCONFIRM For ISPF 4.x., no confirmation prompting for MOVE, REPLACE,
or CANCEL operations.
Remarks
On the first entry of an EDIT or SPFEDIT subcommand, StarTool FDM presents any
pending EDIT recovery sessions to you before entering EDIT for a selected member.
If you enter a : for the member name position, a MEMLIST is provided instead.
VSAM data sets are edited with the PEDIT command. However, use ISPF EDIF services to
access up to 255 characters of any individual record, but the SAVE command is disabled.
You may have chosen a different interface during StarTool FDM installation. Of the
interfaces supported, only PEDIT and EDIF support positioning keywords such as
FROMKEY.
To determine which interface is used, type a CONTROL DEFAULT subcommand and look
for an output line beginning “EDIT calls” with one of the following values:
EDIF - uses the ISPF EDIF interface with up to 255 characters per record
PEDIT - uses PEDIT services
%VSAMMED - uses the MacKinney System’VSAM Utility Edit
EDREC Subcommand
The EDREC subcommand explicitly invokes ISPF edit recovery.
Example
EDREC
Syntax
EDREC
Aliases
EDR, EDRE, EDREC
Operands
No operands are supported for the EDREC subcommand.
Remarks
This subcommand allows you to control when EDIT RECOVERY is to take place. EDIT
RECOVERY procedures are initiated on the first EDIT subcommand. With the EDREC
subcommand you can perform the appropriate action before the first EDIT subcommand.
ENCODE Subcommand
The ENCODE subcommand encrypts a member. This was written with the data encryption
algorithm submitted by IBM to the National Bureau of Standards and published in the
Federal Register.
Example
ENCODE original mymember keyexamp
Syntax
ENCODE input output key [SHR/OLD ]
Aliases
ENC, ENCO, ENCOD, ENCODE
Defaults
OLD
Required
input, output, key
Operands
input The member to be encoded. If this is a 1- to 8-byte simple name it is taken
to be a member name in the current data set; otherwise, it is taken to be
data.set(member)
output The receiving member. If this is a 1- to 8-byte simple name it is taken to be
a member name in the current data set; otherwise, it is taken to be
data.set(member)
key This is a 1- to 8-byte alphanumeric key used for encoding the data set
member.
OLD This allocation is not to be shared with any other allocation for this data set.
SHR This allocation is to be shared with other allocations for this data set.
Remarks
This subcommand encrypts data using the supplied translation key. Since this algorithm
works on eight bytes at a time, the actual number of bytes enciphered or deciphered is an
integral number of eight bytes that is less than or equal to the record length. The greatest
number of bytes left unchanged on a record is the right-most seven bytes.
NOTE This method does not record your key. If you cannot provide the key, the data is
not readable. Use the ENCODE load module independently of StarTool FDM. A HELP entry
is available. Its basic syntax is as follows:
END Subcommand
The END subcommand terminates the STARTOOL command. In ISPMODE, the END
subcommand terminates the current function. Multiple END subcommands are required to
terminate the STARTOOL command.
Example
END
Syntax
END
Aliases
EN, END
Operands
No operands are supported for the END subcommand.
Remarks
In ISPMODE or MEMLIST an END terminates the current function instead of the STARTOOL
command. To terminate StarTool FDM enter repeated END commands or a QUIT
subcommand.
EXCLUDE Subcommand
The EXCLUDE subcommand removes member names from the current MEMLIST. Use
EXCLUDE by itself or as follows:
or
Example
EXCLUDE isp* norent
Syntax
EXCLUDE memgroup
[SINCE/BEFORE ]
[TODAY/YESTERDAY/WEEK/CURRENT/BIWEEK/
MONTH/QUARTER/HALFYEAR/YEAR/BIYEAR/
LAST(numdays)/DATE(yyyy/mm/dd) ]
[CHANGED(yyyy/mm/dd:yyyy/mm/dd) ]
[CREATED(yyyy/mm/dd:yyyy/mm/dd) ]
[ABOVE(Count1) ]
[ALIAS/NOALIAS ]
[AMODE24/AMODE31/AMODE64/AMODEANY/NOAMODE24/
NOAMODE31/NOAMODE64/NOAMODEANY ] (load only)
[AUTH/NOAUTH ] (load only)
[BELOW(Count2) ]
[DC/NODC ] (load only)
[EDIT/NOEDIT ] (load only)
[EXEC/NOEXEC ] (load only)
[FLEVEL/NOFLEVEL ] (load only)
[HASALIAS/NOHASALIAS ]
[ID(Puid)/NOID/NOTID(Puid) ]
[LKED(Partl) ] (load only)
[LOADONLY/NOLOADONLY ] (load only)
[MODULE({* / Fullm / Partm*)} ] (load only)
[NULL/NONULL ]
[ORPHAN/NOORPHAN ]
[OVERLAY/NOOVERLAY ] (load only)
Aliases
EXC, EXCL, EXCLU, EXCLUD, EXCLUDE
Defaults
memgroup, SINCE
Required
none
Operands
memgroup The members to be excluded from the current MEMLIST.
Default member names, member lists, member name ranges,
and member name patterns are allowed. For more
information, see Appendix A, "Formatting Member Names"
SINCE Uses dates from the specified date to the current date. SINCE
indicates that the implied date range (TODAY, YESTERDAY, ...
LAST, DATE) follows the date given. For source modules, the
date referenced is the ISPF modification date. For load
modules, it is the linkage edit date.
FROM Uses dates from the specified date to the current date. FROM
indicates that the implied date range (TODAY, YESTERDAY, ...
LAST, DATE) follows the date given. For source modules, the
date referenced is the ISPF modification date. For load
modules, it is the linkage edit date.
BEFORE Uses dates before (and including) the specified date. BEFORE
indicates that the implied date range (TODAY, YESTERDAY, ...
LAST, DATE) is before the given date. For source modules, the
date referenced is the ISPF modification date. For load
modules, it is the linkage edit date.
USERID(Puid) Excludes members with ISPF statistics and user IDs matching
the partial name, Puid. Enter Puid as a partial TSO user ID
with 1 to 7 characters. USERID is an alias of ID.
NOUSERID Excludes members without ISPF statistics. NOUSERID is an
alias of NOID.
NOTUSERID(Puid) Excludes members without ISPF statistics or members with
ISPF statistics and user IDs that do not match the partial
name, Puid. Enter Puid as a partial TSO user ID with 1 to 7
characters. NOTUSERID is an alias of NOTID.
VSLKED Excludes modules linked by the system linkage editor.
NOVSLKED Excludes modules not linked by the system linkage editor.
ZAP(Partz) Excludes modules with zap IDR data that matches the partial
name, Partz. Enter Partz as partial zap IDR data with one to
eight characters. If you enter MODULE(...), the ZAP operand
applies only to CSECTs whose names satisfy the MODULE
argument.
Remarks
If a member to be excluded is not in the MEMLIST, no action is taken. The following
sample screens show a before image of a member list and an after image showing the
results of an EXCLUDE = RENT.
FUNCTIONS CONTROL A-M LINE CMDS A-M DSN CMDS MEM CMDS A-M FEATURES
CONTROL N-Z LINE CMDS N-Z MEM CMDS N-Z DEFAULTS
----------------------- Load MEMLIST 1, Session# 1 ------- ROW 1 TO 16 OF 138
COMMAND ===> exclude = rent SCROLL ===> CSR
- DSN=SER07.LINK.LOAD,VOL=SER=SER002 MEM=A/ --------------------------------
CMD NAME DATA/MSG ALIASOF LEN/LKED -- ATTRIBUTES -- APF MODE MAIN
ADC2 *ALIAS 87/04/30 REFR RENT ADC2TSO
ADC2ACF2 88/06/02 REFR RENT
ADC2RACF 88/06/06 REFR RENT
ADC2SUB 87/03/23 REFR RENT
ADC2SVC *ALIAS 85/01/17 REFR RENT IGC0024I
ADC2TDSM 87/03/27 REFR RENT
ADC2TSO 87/04/30 REFR RENT
AEV00 89/07/11
AEV10 89/07/11 RENT REUS
AEV20 89/07/11 RENT REUS
AEV50 89/07/11
AEV80 89/07/11 RENT REUS
AEV90 89/07/11 RENT REUS
ASID 87/06/15 RANY
FUNCTIONS CONTROL A-M LINE CMDS A-M DSN CMDS MEM CMDS A-M FEATURES
CONTROL N-Z LINE CMDS N-Z MEM CMDS N-Z DEFAULTS
------------------------------------------------------------------------------
------------------------- Load MEMLIST 1, Session# 1 ----- ROW 1 TO 16 OF 91
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.LINK.LOAD,VOL=SER=SER002 MEM=(ADC2 -----------------------------
CMD NAME DATA/MSG ALIASOF LEN/LKED -- ATTRIBUTES -- APF MODE MAIN
AEV00 89/07/11
AEV50 89/07/11
ASID 87/06/15 RANY
ASIDSP13 82/05/17
ASIDZZ *ALIAS 82/05/17 ASIDMM
ASM 78/02/19 DC
ASMH 82/05/25
ASMH2 82/05/25
ASMTOZAP 81/09/02
AUTO 82/06/16 AC=1
BLAKJACK 82/05/18
CACHE 85/08/04 AC=1
CALCVSAM 84/07/26
CALENDAR 89/03/06
EXEC Subcommand
The EXEC or % subcommand executes a CLIST containing StarTool FDM subcommands.
Use the TSO CLIST processor. Both implicit (%... ) and explicit (EXEC ... ) call forms are
supported.
Example
EXEC lib(clistmem) ‘parms’ list
Syntax
{EXEC clistname ['operands'] / %clistmem [operands]}
Aliases
%, EX, EXE, EXEC
Defaults
none
Required
clistname / clistmem
Operands
clistname The CLIST data set name.
clistmem The name of a member in the CLIST partitioned data set allocated to
FILE(SYSPROC).
operands Optional. May include any CLIST parameters.
Remarks
The % (implied CLIST) and EXEC subcommands are supported in an ISPF dialog
environment. Use the ISPF TSO command to invoke a CLIST that operates under ISPF
(independent of StarTool FDM).
When you enter subcommands from a CLIST (or in batch mode or from a storage stack),
no YES/NO prompts are provided; instead, YES responses are assumed in each case. YES
responses are also assumed if CONTROL NOPROMPT is in effect.
FILTER Function
Use the FILTER command to set selection values for use later by the LISTC/LISTF or MASK
function. The NOFILTER keyword in MASK resets all FILTER options to their defaults.
Example
FILTER novs
Syntax
FILTER [ALL/P/PS/PO/PE/PDS/DA/IS/NOVS/VS/GDG]
[ASSOC/NOASSOC ]
[CHECKCAT/NOCHECK ]
[MIGRAT/NOMIGRAT/ONLYMIGR ]
[OPTICAL/NOOPTICAL ]
[QUICK/NOQUICK ]
[RESET ]
Aliases
FIL, FILT,\ FILTE, FILTER
Defaults
ALL, ASSOC, NOCHECK, MIGRAT, NOOPTICAL, NOQUICK
Required
none
Operands
ALL Default. Searches for all data set types.
P Searches for PS, PO, and PE data sets.
PS Searches for sequential data sets.
PO Searches for partitioned data sets.
PE Searches for partitioned extended data sets.
PDS Searches for PO and PE data sets.
DA Searches for direct data sets.
IS Searches for ISAM data sets.
NOVS Searches for non-VSAM data sets.
VS Searches for VSAM data sets.
GDG Searches for Generation data sets.
ASSOC Default for LISTC. Adds associated components for VSAM clusters.
NOASSOC For LISTC, does not add associated VSAM components.
CHECKCAT For LISTF, checks the catalog status of each data set as it is added.
NOCHECK Default for LISTF. Does not check catalog status.
MIGRAT Default for LISTC. Searches for all data sets.
NOMIGRAT For LISTC, searches for non-migrated data sets.
ONLYMIGR For LISTC, searches for only migrated (MIGRAT or ARCIVE) data
sets.
OPTICAL Opens the VTOC for Optical devices (3395 M151).
NOOPTICAL Default. Does not open the VTOC for optical devices (3395 M151).
QUICK For LISTC, bypasses data set volume verification.
NOQUICK Default for LISTC. Verifies data set volume status.
RESET Resets the FILTER options to default values.
Remarks
Some special considerations apply for the FILTER command:
3 If QUICK is active, only GDG, NOVSAM and VSAM can be checked. P/PS/PO/PE/PDS/
DA/IS all result in non-VSAM data set selection.
FIND Subcommand
The FIND subcommand displays portions of a member that contain a search string.
Optionally, enter the THEN or ELSE keywords to allow conditional execution of other
subcommands. When you enter a THEN keyword, the results of the FIND subcommand
are not displayed unless you also enter the DISPLAY keyword.
Example
FIND membera:memberz ‘this data’
Syntax
FIND memgroup 'search_string'
[NUM|SNUM|NONUM|LBLOCK|LDUMP|BLOCK|DUMP]
[CAPS|ASIS|IGNORE|PICTURE]
[WORD/PREFIX/SUFFIX]
[OFFSET(hexnum) MODULE({*|fullname|part*})]
[AFTER(num) DO(num) MAXMEMBERS(num) COLS(from:to)]
[AND('string2') ACOLS(from:to) {ACAPS|AASIS|AIGNORE|APICTURE}]
[ORx('string3') OCOLS(from:to) {OCAPS|OASIS|OIGNORE|OPICTURE}]
[FORMAT(from:to,from:to, ...)]
[SKIPREC(num) MAXIN(num) MAXOUT(num) MAXFIND(num)]
[SKIPCOL(num) MAXLEN(num) {FIRST|NOFIRST}]
[DISPLAY]
[THEN({ATTRIB|BROWSE|DIRENTRY|DELETE|EDIT|EXCLUDE|FSE|
HISTORY|LIST|MAP|MEMBERS|MEMLIST|NEWML|PRINT|REVIEW|
SUBMIT|SUBLIST|TSOEDIT|TSOLIST|VERIFY|VIEW})]
[ELSE({ATTRIB|BROWSE|DIRENTRY|DELETE|EDIT|EXCLUDE|FSE|
HISTORY|LIST|MAP|MEMBERS|MEMLIST|NEWML|PRINT|REVIEW|
SUBMIT|SUBLIST|TSOEDIT|TSOLIST|VERIFY|VIEW})]
[FROMKEY(key)/FROMADDRESS(address)/FROMNUMBER(num)]1
[TOKEY(key)/TOADDRESS(address)/TONUMBER(num)]1
1NOTE: Supported for VSAM only.
Aliases
FI, FIN
Abbreviations
FKEY for FROMKEY, FADDR for FROMADDRESS, FNUM for FROMNUMBER, TKEY for TOKEY,
TADDR for TOADDRESS, and TNUM for TONUMBER.
Defaults
memgroup, previous search string, IGNORE, NUM or previous LIST/FIND/REPLACE format
Required
None
Operands
memgroup The members to be searched.
Default member names, member lists, member name
ranges, and member name patterns are allowed. For more
information, see Appendix A, "Formatting Member Names".
‘search_string’ The data to be located, delimited by single quotes. If you do
not enter the string or if it is null, the last string entered is
used. The string can contain 1 to 32 characters. If you enter
the ASIS keyword, the string is not translated to upper-case
letters.
As an alternative, enter hexadecimal data as a string
delimited with x’s like x0123456789abcdefx.
A hexadecimal string can contain 1 to 64 characters. x333x
and x0333x are equivalent.
NUM Examines the line number field (the last 8 bytes of a fixed-
format record or the first 8 bytes otherwise) of each logical
record for numerics. If the line number field is not numeric,
switch formatting to NONUM mode for the remainder of the
member.
For ISPF-saved members, the high-order 6 digits of the line
number field is formatted. Otherwise, the low-order 6 digits
of the line number field is formatted by suppressing leading
zeroes. The line number segment is followed by a blank and
up to 249 characters of data from the logical record.
SNUM Discards the line number field (the last 8 bytes of a fixed-
format record or the first 8 bytes otherwise). Searches or
displays up to 256 bytes from a logical record.
NONUM Searches or displays up to 256 bytes from a logical record
(without regard to line numbers).
LBLOCK Formats logical records with two hexadecimal offsets
(displacement in the member and displacement in the logical
record) and segments of up to 64 characters surrounded by
asterisks. Only formatted segments that contain the search
string display. However, a following segment also displays if
the string spans a segment boundary.
For load modules, only CSECT data is searched or displayed
and if a name is entered in a MODULE operand, only those
CSECT or ENTRY names that satisfy the name are searched
or displayed. CSECT records are formatted with two
hexadecimal offsets (a module offset and a CSECT offset)
and segments of up to 64 characters surrounded by
asterisks.
For VSAM records, the first field in the output is the relative
record number for a fixed or variable RRDS. Up to 8 bytes of
the key for a KSDS (if the key is longer than 8 characters, a
+ is placed after the key); otherwise, it is a relative byte
address.
COLS(from:to) Column range to search for the primary string (COLS is only
supported for formats NUM, SNUM, and NONUM). For
example, COLS(1:10) specifies that the string may begin in
columns 1 through 10.
AND('string2') Another string to search in addition to the primary string.
AND strings are supported only for formats NUM, SNUM, or
NONUM and a FIND is reported for a primary string only if
the AND string is found first.
ACOLS(from:to) Column range to search for the AND string. For example,
ACOLS(1:10) specifies that the string can begin in columns 1
through 10.
ACAPS If you use an AND character string argument, it is translated
to upper-case letters.
AASIS If you use an AND character string argument, it is not to be
translated to upper-case letters.
AIGNORE If you use an AND character string argument, searches for
upper- and lower-case data matching the string.
APICTURE If you use an AND character string argument, search for
data with matching characters and the following picture
characters:
= for any character
% for any alphanumeric character
@ for any alphabetic character
# for any numeric character
$ for any special character
~ for any non-blank character (can also use the “not”
character)
. for any invalid character
- for any non-numeric character
< for any lower-case alphabetic character
> for any upper-case alphabetic character
ORx('string3') Another string to search as an alternate to the primary
string. ORx can be OR and OR2 through OR7, for a total of
eight OR conditions. OR strings are supported only for
formats NUM, SNUM or NONUM. A FIND is reported for either
a primary string or an OR string.
OCOLS(from:to) Column range to search for the OR string. For example,
OCOLS(1:10) specifies that the string can begin in columns 1
through 10.
OCAPS If you use an OR character string argument, it is translated
to upper-case letters.
OASIS If you use an OR character string argument, it is not to be
translated to upper-case letters.
OIGNORE If you use an OR character string argument, search for
upper- and lower-case data matching the string.
Remarks
Unprintable characters for 3270-type devices translate to periods before they display.
FIND formats are NUM, SNUM, NONUM, LBLOCK, LDUMP, BLOCK, and DUMP. For load
modules, the NUM, SNUM, and NONUM formats are equivalent to the LDUMP format and
for VSAM data sets, the NUM, SNUM, and NONUM formats are equivalent to the LBLOCK
format.
The default format is initially NUM; however, each time you enter a format operand on a
LIST, FIND, or REPLACE subcommand, the value entered is used as the output format for
subsequent LIST, FIND, and REPLACE subcommands. Also, note the following:
1 Formats NUM, SNUM, and NONUM limit the search and display length for logical
records to 256 characters.
2 Column 72 is not searched for formats NUM or SNUM if the record format is fixed with
80 character records since this is the continuation column.
3 Formats BLOCK and DUMP apply to physical records for non-VSAM data sets (or when
control interval processing is performed). The other formats apply to logical records.
For load modules, LBLOCK and LDUMP formats display only CSECT data.
TIP When using the FIND command against very large data sets (several MB), use
the BLOCK parameter to avoid an ABEND.
4 Formats LBLOCK, LDUMP, BLOCK, and DUMP display only those segments of a record
that contain the search string. A following segment also displays if the string spans a
segment boundary.
5 For VSAM DATA or INDEX components, the LIST, FIND, and REPLACE subcommands
support control interval access using the DUMP or BLOCK display formats. Instead of
accessing individual VSAM records, each GET or PUT obtains a VSAM control interval.
Control interval access is useful if a VSAM data set has logical errors. REPLACE repairs the
error; however, since only the component is opened for update, the next access of the
data set through the related cluster gets warning errors due to the differing time stamps.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------ ISPMODE Session Display ------------- ROW 2891 OF 2946
COMMAND ===> ROLL ===> CSR
- DSN=C911407.LIB.CNTL,VOL=SER=STR802 MEM=PDS99T1* -------------------------
>----->fi pds99t1* / exec /
** FIND PDS99T1A
000800 //ONE EXEC PGM=IEV90,REGION=2048K,
002400 //PDSAPPL EXEC PDSGEN,MEMBER=PDSAPPL
003200 //LK1 EXEC PGM=IEWL,PARM='MAP,RENT,REUS,REFR,LET,NCAL',COND=(0,LT)
004400 //ABEND EXEC PGM=IEFABEND,COND=(0,EQ)
PDS142I 43 lines in this member
** FIND PDS99T1D
000800 //ONE EXEC PGM=IEV90,REGION=2048K,
002800 //*ARSE EXEC PDSGEN,MEMBER=@PARSE
003000 //DIALOG EXEC PDSGEN,MEMBER=@DIALOG
003200 //LK1 EXEC PGM=IEWL,PARM='MAP,RENT,REUS,REFR,LET,NCAL',COND=(0,LT)
004400 //ABEND EXEC PGM=IEFABEND,COND=(0,EQ)
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
---------------------- ISPMODE Session# 1 Log --------- ROW 1,000 TO 1,013 OF 1,013
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.LINK.LOAD,VOL=SER=SER007 MEM=PDSDECRY --------------------------
>----->find pdsdecry x4780c1x ldump
** FIND PDSDECRY
PDS141I AT 000000 CSECT ENCRYPT LENGTH 000015E0
000180 0180 C1D9E240 5000F000 0A0612FF 4780C1A4 *ARS &.0.......Au*
0001B0 01B0 30509180 40064780 C1D248E0 400406E0 *.&j. ...AK...
0001E0 01E0 4780C1FC 48E04004 06E05810 400047F0 *..A..... ..0*
** FIND LMDLIST
Possible return codes are:
PDS142I 125 lines in this member
PDS146I 1 strings found
** FIND LOGOUT
D - terminated StarTool. After StarTool is terminated by CONDEND, the
I - HISTORY member MODULE({* / Fullm / Partm*})
D - MODULE({* / Fullm / Partm*})
RN- LKED(Partl)
RO- LKED(Partl)
I - TRANS(Partt)
D - TRANS(Partt/ ASM / ASMA90 / ASMH / COBOL /
RN- USERDATA(Partu) / SYSMOD(Partu)
RO- USERDATA(Partu) / SYSMOD(Partu)
RN- ZAP(Partz)
RO- ZAP(Partz)
D - Note that if MODULE(Fullm) or TRANS(Partt) is also
FUNCTIONS CONTROL DSN CMDS DATA CMDS A-M DATA CMDS N-Z DEFAULT FEATURE
---------------------- ISPMODE Session# 1 Log ----------ROW 1,000 TO 1,017 OF 1,017
COMMAND ===> ROLL ===> CSR
- DSN=SER07.VSAM.AX.CLUSTER.PATH,VOL=SER=SER007 -----------------------------
>----->find 'vsam' dump
PDS140I DUMP RECORD 23 LENGTH 7,623 RBA 00024576
0007MM F+0010 40C9C4C3 F3F3F5F1 C9405C5C 40E5E2C1 * IDC3351I ** VSA*
0007MM F+0020 D440C040 D6D7C5D5 404F40C3 D3D6E2C5 *M OPEN | CLOSE*
0007MM F+0190 99899587 40E5E2C1 D4409799 968385A2 *ring VSAM proces*
0007MM F+08A0 99969940 81838385 A2A28995 8740E5E2 *ror accessing VS*
0007MM F+08B0 C1D440A5 9693A494 85408481 A381A285 *AM volume datase*
FINDMOD Subcommand
The FINDMOD subcommand searches for all copies of a system routine.
Example
FINDMOD iefbr14
Syntax
FINDMOD module [SYSTEM/NUCLEUS/ADDRESS]
[CHANGE/GO LIB(num) ]
[NOSEARCH ]
Aliases
FINDM, FINDMO, FINDMOD
Defaults
SYSTEM, LIB(1)
Required
module
Operands
module Identifies the member to be found.
SYSTEM Issue a BLDL and search the LPA and MLPA. If the member is in
MLPA, TASKLIB, or LINKLIST, search the LINKLIST concatenation. If
the member is in LPA, search the LPALIB concatenation. Also, search
the in-storage nucleus.
NUCLEUS The search should take place in the in-storage nucleus.
ADDRESS Module is an address whose corresponding routine is to be located in
the LPA, MLPA, or NUCLEUS. Search the LINKLIST libraries if the
module is in MLPA and search the LPALIB concatenation if it is in LPA.
CHANGE Specifies that if the member is found, perform a CHANGE to that
library.
GO Specifies that if the member is found, initiate a GO session for that
library.
LIB(n) If there are multiple finds, LIB specifies which library to select for
CHANGE or GO. If you specify a higher number for LIB than actually
found, the last data set is selected.
NOSEARCH Specifies that the LINKLIST and LPALIB library concatenations are
not to be searched.
Remarks
If FINDMOD is entered with the SYSTEM parameter (the default) the following search
takes place:
3 If the module is in MLPA, TASKLIB, or the LINKLIST, the LINKLIST libraries are
individually searched.
If FINDMOD is entered with the ADDRESS parameter, the module parameter is assumed
to be a hex address and the following search takes place:
If FINDMOD is entered with the NUCLEUS parameter, only the in-storage nucleus map is
searched.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
--------------------- ISPMODE Session# 1 Log ---------- ROW 1,000 TO 1,015 OF 1,015
COMMAND ===> SCROLL ===> CSR
- DSN=ISF.V1R3M2.ISFLPA,VOL=SER=SYSS1C MEM=IGX00011 ------------------------
>----->findmod igx00011 change
PDS293I Member found in LINKLIST DSNAME='ISF.V1R3M2.ISFLPA'
PDS294I Member found in MLPA
PDS295I Address:02A13DD8; length:000200
PDS295I Attributes 1: Reentrant; Reusable; Not loadable only;
PDF295I Attributes 2: Authorized library; Authorized program; Amode 64;
PDF295I Attribute 3: Resident above 16Meg; PLPA resident;
Change 'ISF.V1R3M2.ISFLPA'
PDS200I DISP UNIT RECFM LRECL BLKSIZE ALLOCTRK FREETRK SECONDARY FREEDIR
PDS200I SHR 3390 U 0 6160 1X 6 5 0 TRK 4
FIXPDS Subcommand
The FIXPDS subcommand alters attributes of the current data set. It contains functions
for sequential, PDS, and PDSE data sets. This subcommand also automatically invokes
DSNAME.
Example
FIXPDS RELEASE RECFM(FBA)
Syntax
FIXPDS
[NEWDSNAME(new.data.set.name)]
[MODDSNMAME(data.set.to.modify) MODVOLUME(volume)]1
[ORDER]
[EXPANDDIR(num_add)|FREEDIR(num_unused)|
DIRFREE(percent)|INITDIR(rblks)|
{RESET(tblks)|RESET1|
[CHECK1|NOCHECK1] }]
[RELEASE1|RELEXTENT|RELSAVE(trks)|RELFREE(percent)|MAXSPACE]
[ADDTRK(trks)|ADDCYL(cyls)|ADDFREE(percent)]
[DSCB(offset, hexdata_to_verify, hexdata_to_replace)]1
[*TRK / *CYL / *BLK [*ROUND] ]
[*SPACE(number) ]
[*EXPDT(yyddd) / *RETPD(nnnn) ]
[*MGMTCLAS(mgmtclas) ]
[*STORTCLAS(storclas) ]
[ASM / CLIST / CNTL / LOAD / OBJECT ]
[DSORG(PS/PSU / DA/DAU / PO/POU / IS/ISU / VS/VSU) ]
[RECFM(F/FB/FA/FM/FBA/FBM/V/VB/VA/VM/VBA/VBM/U/UA/UM)]
[LRECL(L1) ]
[*BLKSIZE(L2) ]
[*OPTCD(W/WC/WCZ/C/CZ/Z) / *NOOPTCD ]
1
NOTE: Supported for PDSE data sets.
Aliases
FIX, FIXP, FIXPD
Defaults
NOCHECK, RECFM(previous value), LRECL(previous value), BLKSIZE(previous value),
OPTCD(previous value)
Required
none
Operands
EXPANDDIR(#add) Expands the directory by adding #add unused directory
blocks. Type #add as a number from 0 through 99999.
The default is 50.
FREEDIR(#unused) Expands or reduces the directory as necessary to obtain
#unused free directory blocks. Type #unused as a
number from 0 through 99999. It defaults to 5.
ORDER Reads the directory looking for members that are
duplicates or out of order. Each such member causes a
prompting sequence before any fix is attempted. For out
of order members, the member is renamed back to itself
in two steps so that it can be placed in collating sequence.
For duplicate member names, one of the members is
renamed (to a name low in the collating sequence).
Dispose of either one or both later.
RESET(Totblks) Writes over the current directory with empty directory
blocks. Enter totblks as a number from 1 through 99999.
It defaults to the number of directory blocks already
allocated.
After the directory blocks are written, the end of data
marker (DS1LSTAR) is reset to indicate an empty
partitioned data set. This is the equivalent of a
COMPRESS for an empty partitioned data set.
RESET Reset the data set to an empty data set.
INITDIR(rblks) Writes over the current directory with empty directory
blocks. Enter rblks as a number from 1 through 99999. It
defaults to the number of directory blocks already
allocated. The data set end of data marker (DS1LSTAR) is
not modified as for RESET.
CHECK Check each member to see if it is being edited for options
RESET or INITDIR.
NOCHECK No edit check is desired.
DIRFREE(perc) Specifies the percent of free directory blocks desired (0 to
999). For example, if 20 is entered for a data set with 50
used directory blocks, the number of free directory blocks
will be adjusted (up or down) to 10.
ADDFREE(perc) Specifies the percent of unused space to be available in a
data set (0 to 999). For example, if 20 is entered for a
data set with 50 used tracks and 5 free tracks, another 5
tracks will be added to the data set in track or cylinder
increments. If RELFREE and ADDFREE are both used,
ADDFREE is performed first.
RELFREE(perc) Specifies the percent of unused space to be retained in a
data set (0 to 999). For example, if 20 is entered for a
data set with 50 used tracks, any unused space past track
60 will be returned to the system. If the data set was
allocated with cylinder secondary space, any returned
disk space will maintain cylinder boundaries for the data
set. If RELFREE and ADDFREE are both used, ADDFREE is
performed first.
RELEASE Returns any unused disk space in the current data set to
the system. If the data set was allocated with cylinder
secondary space, any returned disk space will maintain
cylinder boundaries for the data set.
RELEXTENT Returns any unused disk extents to the system.
RELSAVE(nnn) Returns any unused disk space in the current data set to
the system except for the first nnn tracks. If the data set
was allocated with cylinder secondary space, any
returned disk space will maintain cylinder boundaries for
the data set.
MAXSPACE Marks all extents of the data set as “in-use” by adjusting
the end of data set marker (DS1LSTAR). This could be
used after a data set compress to RESTORE members
after the used portion of the data set.
ADDTRK(trka) Adds a single secondary extent of trka tracks to the data
set.
This operation is independent of secondary space
indicators from the data set label.
ADDCYL(cyla) Adds a single secondary extent of cyla cylinders to the
data set.
This operation is independent of secondary space
indicators from the data set label.
DSCB(offs,ver,rep) Modify the Format 1 DSCB as specified by the OFFS, VER,
and REP parameters. The DSCB keyword may contain
multiple sets of OFFS, VER, and REP.
For example, the following subcommand changes the first
character of DS1DSSN and sets DS1EXPDT to zero if it is
set to any 1995 value:
FIXPDS DSCB(2D C1C2C3C4C5C6 F1 38 5F 000000)
Each OFFSET may vary from 2C to 8C.
Each VER must contain 2 to 20 hexadecimal characters
that are checked against the corresponding DSCB data. If
any VER fails, the DSCB keyword has no effect.
Each REP must contain 2 to 20 hexadecimal characters
that are used to update corresponding DSCB data.
If all sets of OFFS, VER and REP are processed
successfully and you confirm that these changes are
desirable, DSCB updates are performed by PDSEAUTH.
NEWDSNAME(dsname) Specifies a new data set name for an uncataloged data
set on a non-indexed volume.
If the new DSNAME begins with ‘NULL..” the data set is
also deleted. If you are authorized to use this facility,
Format 1 DSCB updates are made with PDSEAUTH. This
facility can rename a data set even if it is ENQUEUED.
MODDSNAME(dsname) Specifies a data set whose Format 1 DSCB is to be
modified. If you are authorized to use this facility, DSCB
updates are made with PDSEAUTH. Use this facility to
repair damaged data sets even if they cannot be allocated
directly.
MODVOLUME(volume) A volume name for use with the MODDSNAME keyword if
the data set is not cataloged or is mis-cataloged.
DSORG(Newd) The desired data set organization for the data set. Normally, the
DSORG of a data set would only be changed to add or remove the
U (Unmoveable) attribute; however, the DSORG of DA and PS type
data sets are sometimes also manipulated. The new DSORG may
be any of the following: PS, PSU, DA, DAU, PO, POU, VS, VSU, IS,
or ISU.
Changing this parameter does not change the data set physically
The new value is just changed in the data set label (Format 1
DSCB).
RECFM(Newr) A new DCB RECFM value for the data set. Newr defaults to its
previous value for the data set or may be entered as any one of
the following: F, FB, FA, FBA, FM, FBM, V, VB, VA, VBA, VM, VBM,
U, UA, or UM.
Changing this parameter does not change the data set physically.
The new value is just changed in the data set label (Format 1
DSCB).
LRECL(L1) A new DCB LRECL value for the data set. L1 defaults to its
previous value for the data set or may be entered as a number
from 1 through 32767.
Changing this parameter does not change the data set physically.
The new value is just changed in the data set label (Format 1
DSCB).
BLKSIZE(L2) A new DCB BLKSIZE value for the data set. L2 defaults to its
previous value for the data set or may be entered as a number
from 1 through 32767.
Changing this parameter does not change the data set physically.
The new value is just changed in the data set label (Format 1
DSCB).
OPTCD(Newo) The desired OPTCD value for the data set. Newo defaults to its
previous value for the data set or may be changed to any of the
following: W, WC, WCZ, C, CZ, or Z.
NOOPTCD Turn off any current W, C, or Z OPTCD value.
Remarks
After a FIXPDS subcommand gains control, it writes messages regarding the data set
action to be taken and any potential error conditions. FIXPDS prompts you before making
any data set changes unless CONTROL NOPROMPT is in effect. If you invoke the FIXPDS
subcommand with no operands in an ISPF environment, StarTool FDM prompts with a
panel appropriate for the type of data set you are currently processing.
The following are more detailed logic notes on several of the different functions available
through the FIXPDS subcommand.
INITDIR (initialize the If any members exist in the data set, a warning message is
directory — ignored for issued
sequential)
If CHECK is specified and any members are in use by an
ISPF edit session, a warning message is issued
The data set’s directory blocks are rewritten with null data,
destroying any existing member information
The end of data marker (DS1LSTAR) is not modified
RECFM, LRECL, If a data type keyword such as ASM, CLIST, CNTL, LOAD, or
BLKSIZE (modify the OBJECT is entered, RECFM and LRECL default values are
DCB attributes — a provided from a table and a BLKSIZE value is determined
warning is issued) based on the allocated device type
If any RECFM, LRECL, or BLKSIZE values are specifically
requested by keyword, these values will override the values
as determined from the data type keywords entered
The data set is opened for output with these new DCB
parameters
RELEASE (return space If the data set is currently open, an error message is issued
to operating system)
The amount of space and the type of units (TRK or CYL) is
determined
The data set is opened with EXTEND to get the space
released
MAXSPACE (mark all All extents of the data set are marked in use by setting the
allocated space in use) end of data marker (DS1LSTAR) value to the last disk
address for the data set. Use this with a RESTORE
subcommand to recover members that were deleted prior
to a data set compress. It may also be possible to resurrect
members lost from a PDS after the directory is overwritten
by sequential output due to some sort of JCL or procedural
error. The sequential data blocks take one or more tracks
followed by the end of file marker in the disk tracks
formerly occupied by the directory. To attempt recovery of
PDS members located after the overwritten tracks, enter:
FIXPDS MAXSPACE
(to mark all allocated space in use)
FIXPDS INITDIR(43) ADDTRK(1)
(to reinitialize the directory and add another extent)
RESTORE name REPEAT NOPROMPT NODISPLAY
(to restore all deleted members)
VERIFY :
(to find invalid members after the previous DS1LSTAR)
BROWSE name
(to scan contents of members)
RENAME name realname
(to name needed members properly)
DELETE name
(to delete members not needed)
COMPRESS
(to clean up unused space again)
ADDTRK or ADDCYL An extent is added to the data set in the units given in the
(add one secondary keyword. For example, ADDTRK(12) adds one secondary
extent) extent of 12 tracks while ADDCYL(4) adds one secondary
extent of 4 cylinders
This operation is independent of any secondary extent
information associated with the data set. It can add a single
extent of the specified size to a data set even if the data set
was allocated without secondary extents.
StarTool FDM issues a warning message if you attempt to
add a secondary extent to any data set named
'xxx.NUCLEUS' (where xxx is any dsname prefix).
Secondary extents are not supported for the
‘SYS1.NUCLEUS’ data set. If this data set were used as an
operating system NUCLEUS data set, you could not IPL!
StarTool FDM also issues a warning message if you attempt
to add an extent to a LINKLIST data set. While this is
supported by the operating system, the extent would not be
available for use until the next system IPL.
NEWDSNAME (rename), A prompt panel displays showing current DSCB value. This
MODDSNAME, and panel contains field-level help to provide guidance.If any
DSCB (direct DSCB changes are made in this panel, a FIXPDS DSCB
update) subcommand will be generated
From the FIXPDS panel, The DSCB keyword may contain multiple triples of
select “Examine or hexadecimal information with values for: OFFSET VER REP
update DSCB”.
As an example, the following subcommand changes the first
character of DS1DSSN and sets DS1EXPDT to zero if it is set
to any 1995 value:
FIXPDS DSCB(2D C1C2C3C4C5C6 F1 38 5F
000000)
Each OFFSET may vary from 2C to 8C
Each VER must contain 2 to 20 hexadecimal characters
which are checked against the corresponding DSCB data
If any VER fails, the DSCB keyword has no effect
Each REP must contain 2 to 20 hexadecimal characters
which are used to update corresponding DSCB data
If all sets of OFFS, VER, and REP are processed without
problems and you confirm that these changes are desirable,
DSCB updates will be performed by PDSEAUTH
Since DSCB operates on a conditional basis, it can be set up
to operate on a global basis where only matching data sets
are modified, as in the following example:
PDS200I DISP UNIT OPT RECFM LRECL BLKSIZE ALLOCTRK FREETRK SECONDARY FREEDIR
PDS200I SHR 3380 C FB 80 9040 1X 47 10 40 TRK 25
PDS200I DISP UNIT OPT RECFM LRECL BLKSIZE ALLOCTRK FREETRK SECONDARY FREEDIR
PDS200I SHR 3380 C FB 80 9040 1X 47 10 40 TRK 45
PDS200I DISP UNIT RECFM LRECL BLKSIZE ALLOCTRK FREETRK SECONDARY FREEDIR
PDS200I SHR 3390 VB 255 32760 1X 10 0 3 TRK 1
PDS200I DISP UNIT RECFM LRECL BLKSIZE ALLOCTRK FREETRK SECONDARY FREEDIR
PDS200I SHR 3390 VB 255 32760 2X 15 5 3 TRK 1
FSE Subcommand
The FSE subcommand edits a member. Use the TSO FSE command.
Example
FSE mema:memb cntl
Syntax
FSE memgroup [ASIS
[OLD/NEW
[NONUM
[ASM/BASIC/CLIST/CNTL/COBOL/DATA/
FORTE/FORTG/FORTGI/FORTH/GOFORT/
IPLI/LIST/PLI/PLIF/TEXT/VSBASIC ]
Aliases
FS, FSE
Defaults
memgroup, EDIT type based on the data set name
Required
none
Operands
memgroup Identifies the members to be edited.
Default member names, member lists, member name range, and
member name patterns are allowed. For more information, see
Appendix A, "Formatting Member Names".
ASIS Edits the member with upper- and lower-case characters.
OLD Verifies that the member exists before calling FSE.
NEW Verifies that the member does not exist before calling FSE.
NONUM Edits the member without using line numbers.
ASM EDIT type is assembly.
BASIC EDIT type is BASIC.
CLIST EDIT type is CLIST.
CNTL EDIT type is CNTL.
COBOL EDIT type is COBOL.
DATA EDIT type is DATA.
FORTE EDIT type is FORTRAN level “E”.
FORTG EDIT type is FORTRAN level “G”.
FORTGI EDIT type is FORTRAN level “GI”.
FORTH EDIT type is FORTRAN level “H”.
GOFORT EDIT type is GOFORT.
IPLI EDIT type is IPLI.
LIST EDIT type is LIST.
PLI EDIT type is PLI.
PLIF EDIT type is PLI (F-level).
TEXT EDIT type is TEXT.
VSBASIC EDIT type is VSBASIC.
Remarks
If you enter an EDIT type keyword, that keyword is passed to FSE as the descriptive
qualifier; otherwise, a descriptive qualifier is chosen as follows:
1 If the low-level qualifier of the partitioned data set name is one of the valid descriptive
qualifiers for FSE (ASM, BASIC, CLIST, CNTL, COBOL, DATA, IPLI, LIST, PLI, TEXT, or
VSBASIC), that qualifier is passed to FSE.
3 Otherwise, the data type qualifier is not a valid descriptive qualifier and the general
descriptive qualifier, DATA, is passed to FSE.
This interface is optional, and should only be used if you have FSE+ installed at your
installation.
GO Function
The GO command allows you to initiate or switch to parallel StarTool FDM sessions.
Example
GO ‘sys1.parmlib’
Syntax
GO [* / ** / gonum / dsname [VOLUME(volser)] [SHR/OLD]
/ FILE(ddname) [NUMBER(num)]
[REPLACE ]
Aliases
G, GO
Defaults
SHR or previously used GO data set if an * is entered.
Required
none
Operands
* Switches to the most recently used GO session. Use this to
toggle GO sessions. This is similar to the toggling for CHANGE
*.
** Rotates through active GO sessions. Set a PF key to GO **.
gonum The number (1 through 9) of the parallel session to initiate or
switch to.
dsname The data set name for the parallel session to initiate or switch
to. If the data set name is not entered in single quotes (‘), your
TSO PREFIX is appended to the start of the entered data set
name.
VOLUME(volser) The volume name to use for uncataloged data sets.
SHR Allocates the data set with a disposition of SHR; allows
simultaneous use of this data set by others. The use of SHR is
recommended.
OLD Allocates the data set with a disposition of OLD; does not allow
simultaneous use of this data set by others. The use of SHR is
recommended.
FILE(ddname) Identifies the DDNAME of a pre-allocated data set. Only disk
data sets (including VIO) are supported. If you use the FILE
keyword, then dsname, SHR/OLD, VOLSET, and VOLUME should
not also be used. If the data set is concatenated, use the SHR or
OLD keyword since StarTool FDM reallocates the data set.
NUMBER(num) The concatenation number desired for the DDNAME allocation
for the FILE keyword. num defaults to 1 but if num is larger than
the number of concatenated data sets, the last data set in the
sequence is used.
REPLACE Replaces a session (this is when a session number and a data
set name are both specified).
Remarks
The initial session invoked by StarTool FDM is called GO session 1. To establish an
alternate parallel session, enter GO and a session number or a data set name. StarTool
FDM prompts for the data set name, if necessary. A parallel session is initiated. To transfer
to an established parallel session, enter GO and the session number or data set name.
When you are in an alternate session, the log is shared between sessions. MEMLIST,
CSECTS, and ZAP processing is maintained uniquely between the different sessions. The
other functions are shared between sessions.
HELP Subcommand
The HELP subcommand provides information for using StarTool FDM. HELP operates
differently depending on your operating mode. For example, if you are in ISPMODE or
MEMLIST, HELP provides standard ISPF tutorial information. In line mode or batch, the
HELP subcommand lists data from the HELP data set.
Example
HELP
Syntax
HELP [subcommand [FUNCTION] [SYNTAX] [OPERAND/OPERAND(k)]]
Note: the above operands are only defined in line mode or batch.
Aliases
H, HE, HEL, HELP
Defaults
none
Required
none
Operands
subcommand The name of a subcommand (or the alias name of a subcommand)
for which HELP is to be displayed. If this operand is omitted, a list
of valid subcommands displays.
FUNCTION Display function information for the subcommand.
SYNTAX Display syntax information for the subcommand.
OPERAND(k) Display information for the keyword identified in the (k) operand. If
the (k) operand is omitted, information on all operands of the
subcommand displays.
Remarks
The HELP subcommand provides information on using StarTool FDM.
Use either the TSO HELP or HEL command. This choice is made during StarTool FDM
installation. To determine which program is used, enter a CONTROL DEFAULT
subcommand and look for an output line beginning “HELP calls”.
This interface is optional. Use it only with the HELP command processor or the public
domain HEL command.
HEX Function
The HEX command performs hexadecimal calculations.
Example
HEX
Syntax
HEX
Aliases
HEX
Operands
No operands are supported for the HEX subcommand.
Remarks
The HEX ISPF table displays in response to a HEX command. When you are in a HEX
display, you can delete a part of the table, find data in the table, print a part of the table,
store a part of the table in a data set, etc. For assistance with the different options
available, use the HELP command, CUA functions, or enter an O command as a primary
command.
The HEX table displays the calculator tape for your calculator. Enter new calculations from
the HEX display.
The following primary commands are supported directly for the HEX function. For
information on ISPMODE commands available in StarTool FDM, see <Xref>“Common
Commands” in Chapter 2, "ISPF Interface Commands".
RF[IND] Finds a string (repeat find) and positions the display start location.
PF keys 5 and 17 are normally set to RFIND.
X Clears the HEX table relative to the cursor position.
Syntax X [ABOVE/BELOW/ALL]
HISTORY Subcommand
The HISTORY subcommand displays the last linkage edit date for a module and lists any
CSECT IDR data assigned to that load module.
Example
HISTORY mema:memb
Syntax
HISTORY memgroup
[ML|MEMLIST|NEWML|SUBLIST]
[MODULE({*|Fullname|Part*}) {ASIS|UPPERCASE|UC}]
[COBOL(ADV|NOADV, APOST|NOAPOST,
AWO|NOAWO, CMPR2|NOCMPR2,
COUNT|NOCOUNT, COMPCLASS|COMPPROGRAM,
CURRENCY|NOCURRENCY, DATA24|NODATA24,
DATA31|NODATA31, DATEPROC|NODATEPROC,
DBCS|NODBCS, DECK|NODECK,
DUMP|NODUMP, DYNAM|NODYNAM,
ENDJOB|NOENDJOB, EVENTS|NOEVENTS,
FASTSRT|NOFASTSRT, FDUMP|NOFDUMP,
INTDATELIL|INTDATEANSI, FLOW|NOFLOW,
LIB|NOLIB, LIST|NOLIST,
MAP|NOMAP, NAME|NONAME,
NUMBER|NONUMBER, NUMCLSALT|NUMCLSPRIM,
NUMPROCMIG|NONUMPROCMIG, NUMPROCPFD|NONUMPROCPFD,
OBJECT|NOOBJECT, OBJ370|NOOBJ370,
OFFSET|NOOFFSET, OPTFULL|NOOPT,
OPTIMIZE|NOOPTIMIZE, OUTDD|NOOUTDD,
PGMLONGMIX|NOPGMLONGMIX, PGMLONGUPP|NOPGMLONGUPP,
QUOTE|NOQUOTE, READYTRACE|NOREADYTRACE,
RENT|NORENT, RESIDENT|NORESIDENT,
RMODEANY|RMODE24, SEQUENCE|NOSEQUENCE,
SIZEMAX|NOSIZEMAX, SOURCE|NOSOURCE,
SSRANGE|NOSSRANGE, STATE|NOSTATE,
SYMDMP|NOSYMDMP, TERMINAL|NOTERMINAL,
TEST|NOTEST, TESTBLOCK|NOTESTBLOCK,
TESTPATH|NOTESTPATH, TESTSTMT|NOTESTSTMT,
TRUNCBIN|TRUNCBIN, TRUNCSTD|NOTRUNCSTD,
VBREF|NOVBREF, WORD|NOWORD,
XREF|NOXREF, ZWB|NOZWB)]
[EXTERN|WKEXTERN|PSEUDOREG|LABELREF|COMMON|PRIVATE|CSECT]
[GENERATE|CMNLOAD]
[ALL|
{LKED(Lpartname)|NOLKED}
{TRANS(Tpartname|ASM|ASMA90|ASMH|C|C++ZOS|C370|COBOL|
COBOLII|COBOLMVS|COBOLOS|COBOLVS|COBOLV4|COBOLZOS|
FORTRAN|FORTRANG|FORTRANH|FORTRANV|IFOX|PASCAL|
PLS|PL/X-390|PL1|PLX370|REXX370|RPG|SASC)|NOTRANS}
{ZAP(Zpartname)|NOZAP}]
[USERDATA(Upartname)|SYSMOD(Upartname)|NOUSERDATA|NOSYSMOD]
[NOSYSTEM]
Aliases
HI, HIS, HIST, HISTO, HISTOR, HISTORY
Defaults
memgroup, UPPERCASE, ALL, TRANS (from CONTROL), LKED, ZAP, and USERDATA. If LKED,
TRANS, ZAP, or USERDATA are specified, only the corresponding types of data are
provided.
Required
none
Operands
memgroup Identifies the load members for which you want history data,
using standard MEMGROUP syntax.
Default member names, member lists, member name ranges,
and member name patterns are allowed; for more information,
see Appendix A, "Formatting Member Names".
MODULE(name) Specifies a 1- to 8-byte partial external name that limits CSECT
names for history reporting. If you enter this parameter with any
TRANS SYSMOD/USERDATA or ZAP keywords, only those CSECTs
that satisfy the MODULE keyword are checked for the other
keyword conditions.
The MODULE operand takes the following forms:
MODULE(*) – uses name entered in the previous MODULE option
MODULE(Fullname) – reports on CSECTs with this name only
MODULE(Part*) – reports on CSECTs with names conforming to
this wildcard pattern
ASIS|UPPERCASE Lets the user specify how the MODULE(name) parameter is
processed. This parameter must immediately follow the MODULE
parameter in the parameter list. It takes one of the following
values:
ASIS Case is respected as typed for the CSECT name in
the MODULE(name) parameter.
UPPERCASE The CSECT name in the MODULE(name) parameter is
converted to uppercase characters before executing
the HISTORY command. This is the default value.
The alias UC is accepted for this value.
Customers using C++ translators and customers with lower-case
CSECT names in their code should use the ASIS parameter with
the HISTORY command.
GENERATE Filter and reformat output from the HISTORY subcommand into a
form that can be processed by a program or a REXX exec as
described briefly below:
The ** HIST message contains linkage edit attributes for the
module
The PDS250I message shows all bit settings for COBOL VS and V4
The PDS251I message TYP field contains ASM, PL1, FOR, RPG, REX,
C37, MAP, or ??? with the third character overlaid with D (for DB2),
I (for IMS), O (for ONLINE), B (for DB2 and ONLINE), or S (for
Secondary if the CSECT name is not the same as the module name)
The PDS255I message contains all run time option bit settings for
COBOL II, COBOL for MVS & VM, or COBOL for OS/390 & VM
The PDS260I message contains all bit settings for COBOL II,
COBOL for MVS & VM or COBOL for OS/390 & VM and the TYP field
will be II, MVS or OS with the third character overlaid with D (for
DB2), I (for IMS), O (for ONLINE), B (for DB2 and ONLINE), or S
(for Secondary if the CSECT name is not the same as the module
name)
Most other HISTORY messages are suppressed
The format of each message with GENERATE is defined in the
PDS250I, PDS251I, PDS255I, and PDS260I message section. The
**HIST message separator line is changed as shown below:
** HIST COBOLTST Linkage attributes
Col 9: CSECT name
Col 23: RENT or blank
Col 28: REUS or blank
Col 33: REFR or blank
Col 38: OVLY or blank
Col 43: TEST or blank
Col 48: SCTR (scatter loaded) or blank
Remarks
If any CSECTS in a load member were compiled by a COBOL compiler, several compile-
time options are listed for each COBOL CSECT (see messages PDS250I and PDS260I for
more information).
If a member is not a load module, any ISPF statistics or any SSI information are displayed
for the member and any HISTORY keyword information is ignored.
If DFSMS APAR OW29593 is applied on your system, the binder records hours, minutes
and seconds as well as the date in the history IDR record. The StarTool FDM PDS064I
message reports this information in HH:MM format if it is present:
** HISTORY ADC2SUB
PDS061I AMASPZAP update history by CSECT -
ADC2SUB 88/01/29 E230300
ADC2SUB 87/12/01 E230232
PDS062I User-supplied update history by CSECT -
ADC2LSV5 87/01/28 E230128 -- LOG RETRIEVAL 87/01/27 LEL
ADC2LSV1 86/02/26 ADD PATCH AND COPYRITE 86/02/26 MON
PDS063I ChangeMan module ADC2SUB package CO10000007 date 1987/03/23 time 10:33
PDS064I Last link-edited on 87/03/23 by LKED 566529508 V01 M00
** HISTORY COBOLCAP
PDS060I Translator history by CSECT -
DSN0MGF 85/08/09 566895801-COBOLII V11 M00
PDS260I CSECT____VER_TEST_SSRANG_OPT_CMPR2_ZWB_NUMPR_TRUNC_RES_RENT_DYNAM_DATA
PDS260I DSN0MGF IIS SSRANG OPT ZWB (PFD) (OPT) RES RENT 31/C
** HISTORY COBOLCA2
PDS060I Translator history by CSECT -
DSN0MGF 85/08/09 566895801-COBOLII V11 M00
PDS260I CSECT____VER_TEST_SSRANG_OPT_CMPR2_ZWB_NUMPR_TRUNC_RES_RENT_DYNAM_DATA
PDS260I DSN0MGF IIS SSRANG OPT ZWB (PFD) (OPT) RES RENT 31/C
** HISTORY IDCAMS
PDS062I User-supplied update history by CSECT -
IDCSA03 92/10/15 UY73238
IDCTP06 91/10/01 UY59099
IDCEX02 90/12/19 RSI03481661
PDS063I ChangeMan module IDCAMS package CO10000017 date 1992/10/15 time 10:33
PDS064I Last link-edited on 92/10/15 by LKED 566528408 V03 M03
>------>hi : cobol(ssrange,test) ml
** HISTORY COBMVS
PDS260I CSECT____VER_TEST_SSRANG_OPT_CMPR2_ZWB_NUMPR_TRUNC_RES_RENT_DYNAM_DATA
PDS260I COBTEST MVS TEST SSRANG OPT ZWB (MIG) (STD) RES RENT 31
** HISTORY COBOLFFF
PDS260I CSECT____VER_TEST_SSRANG_OPT_CMPR2_ZWB_NUMPR_TRUNC_RES_RENT_DYNAM_DATA
PDS260I DSN0MGF MVS TEST SSRANG OPT CMPR2 ZWB (MIG) (BIN) RES RENT DYNAM 31
PDS255I Run-time options:
DEBUG, SSRANGE, STAE, NOAIXBLD, NOSPOUT, NORTEREUS, NOLIBKEEP, NOWSCLEAR, NOMI
** HISTORY COBOL45
PDS250I CSECT____VER_COUNT_FLOW_STATE_TEST_TRACE_RES_ENDJOB_SYMD_OBJ_OPTIMIZE_
PDS250I H4810001 VSS TEST RES ENDJOB COBOL
** HISTORY COBOLA
PDS250I CSECT____VER_COUNT_FLOW_STATE_TEST_TRACE_RES_ENDJOB_SYMD_OBJ_OPTIMIZE
PDS250I CZARVSY VS2 FLOW TEST RES ENDJOB SYMD 370 OPTIMIZE
PDS062I User-supplied update history by CSECT -
DFSLI000 83/06/16 RSI31640356
PDS063I ChangeMan module COBOLA package CO10000027 date 1989/12/01 time 10:33
PDS064I Last link-edited on 89/12/01 by LKED 566528408 V02 M03
** HISTORY COBOLRAN
PDS260I CSECT___VER_TEST_SSRANG_OPT_CMPR2_ZWB_NUMPR_TRUNC_RES_RENT_DYNAM_DATA
PDS260I DSN0MGF IID SSRANG OPT ZWB NOPFD (STD) RES RENT 31/CA
PDS260I DSN0MGZ IID SSRANG OPT ZWB (PFD) (BIN) RES RENT 31/CA
PDS255I Run-time options:
DEBUG, SSRANGE, STAE, NOAIXBLD, NOSPOUT, NORTEREUS, NOLIBKEEP, NOWSCLEAR, NMIX
PDS062I User-supplied update history by CSECT -
IGZEBST 85/05/06 UP52062
ISPLINK 84/11/26 RSI43240150
** HISTORY COBOL6
PDS060I Translator history by CSECT -
HM01A 1985/01/29 40CB1-COBOLVS V20 M00
DATECALC 1983/06/20 5734AS100-IFOX00 V05 M01
UABEND 1983/06/20 5734AS100-IFOX00 V05 M01
PDS250I CSECT____VER_COUNT_FLOW_STATE_TEST_TRACE_RES_ENDJOB_SYMD_OBJ_OPTIMIZE_
PDS250I HM01A VSS ENDJOB 370 CAPEX
PDS061I AMASPZAP update history by CSECT -
PDS067I Member has 1 IDR blocks with space for 19 IDR entries
PDS068I 1 IDR entries are in use; 18 are available for use
PDS063I ChangeMan module COBOL6 package CO10000027 date 1989/12/01 time 10:33
PDS064I Last link-edited on 1989/12/01 by 566528408-DFPLKED V02 M03
** HISTORY DSX0MGF
PDS060I Translator history by CSECT -
DSX0MGF 1985/08/09 566895801-COBOLMVS V11 M00
PDS260I CSECT____VER_TEST_SSRANG_OPT_CMPR2_ZWB_NUMPR_TRUNC_RES_RENT_DYNAM_DATA
PDS260I DSX0MGF IID SSRANG OPT ZWB (PFD) (OPT) RES RENT 31
PDS061I AMASPZAP update history by CSECT -
PDS067I Member has 1 IDR blocks with space for 19 IDR entries
PDS068I 1 IDR entries are in use; 18 are available for use
PDS063I ChangeMan module DSXOMGF package CO10000127 date 1991/06/25 time 10:33
PDS064I Last link-edited on 1991/06/25 by 566528408-DFPLKED V03 M01
** HISTORY COBOS390
PDS060I Translator history by CSECT -
COBTEST 1998/04/23 5648A2500-COBOLOS V12 M00
PDS260I CSECT____VER_TEST_SSRANG_OPT_CMPR2_ZWB_NUMPR_TRUNC_RES_RENT_DYNAM_DATA
PDS260I COBTEST OSS ZWB NOPFD (STD) RES 31
PDS067I Member has 1 IDR blocks with space for 19 IDR entries
PDS068I 1 IDR entries are in use; 18 are available for use
PDS063I ChangeMan module COBOS390 package CO10000327 date 1998/04/23 time 10:33
PDS064I Last link-edited on 1998/04/23 by 5695DF108-BINDER V01 M01
IDCAMS Subcommand
The IDCAMS subcommand invokes IDCAMS passing it a command and operands and
displays the output from the command.
Example
IDCAMS listcat entry(userid.vsam.ix.cluster) all
Syntax
IDCAMS command operands
Aliases
ID, IDC, IDCA, IDCAM, IDCAMS
Defaults
none
Required
IDCAMS command and operands; if no IDCAMS command is entered in ISPF mode, an
IDCAMS prompting sequence is initiated.
Operands
command Specifies the IDCAMS command: ALLOCATE, ALTER, BLDINDEX,
CNVTCAT, DEFINE, DELETE, EXAMINE, EXPORT, IMPORT, LISTCAT,
PRINT, REPRO, or VERIFY. IDCAMS is invoked as an APF-authorized
processor through the TSO/E IKJEFTSR interface. Operations on a
catalog that require authorization (DEFINE with RECATALOG, DEFINE
with RECOVERY, EXPORT, IMPORT, PRINT, REPRO, or VERIFY) can be
performed.
operands Any additional operands for the command. For example, DEFINE needs
an initial operand of ALIAS, AIX, CLUSTER, GDG, NONVSAM,
PAGESPACE, PATH, or USERCATALOG followed by additional operands to
complete the DEFINE command.
Remarks
If you invoke the IDCAMS subcommand with no operands in an ISPF environment, you
are prompted for which of several IDCAMS commands you want to perform. Previous
operands entered for each command are remembered across ISPF sessions.
If you use the IDCAMS prompting interface, normal TSO conventions are used for data
set names but catalog names must be fully qualified. When IDCAMS is invoked with a
command and operands, all data set and catalog names must be fully qualified but you
can optionally use quotation marks around data set names.
DEFINE is a short-hand command for entering IDCAMS with no operands and selecting
the DEFINE option.
IDCAMS;DEFINE;KSDS
or
DEFINE;KSDS
IF Subcommand
The IF subcommand searches for members that meet defined conditions. The action to be
taken is specified by the THEN and ELSE keywords. You can omit the THEN or ELSE
keyword. If you omit both THEN and ELSE, a default of THEN(ATTRIB) is assumed.
If all conditions are met for a given member, any THEN action is taken for that member;
otherwise, any ELSE action is taken.
Example
IF mema:memb changed(93/11/24:93/11/30) then(edit)
Syntax
IF memgroup
[SINCE/BEFORE ]
[TODAY/YESTERDAY/WEEK/CURRENT/BIWEEK/
MONTH/QUARTER/HALFYEAR/YEAR/BIYEAR/
LAST(numdays)/DATE(yyyy/mm/dd) ]
[CHANGED(yyyy/mm/dd:yyyy/mm/dd) ]
[CREATED(yyyy/mm/dd:yyyy/mm/dd) ]
[ABOVE(Count1) ]
[ALIAS/NOALIAS ]
[AMODE24/AMODE31/AMODE64/AMODEANY/NOAMODE24/NOMODE31
NOAMODE64/NOAMODEANY ] (load only)
* [APFERR/NOAPFERR ] (load only)
* [APPARENTALIAS/NOAPPARENTALIAS ]
[AUTH/NOAUTH ] (load only)
[BELOW(Count2) ]
* [BLOCKERR/MAXBLK(size)/NOBLOCKERR ]
[DC/NODC ] (load only)
[EDIT/NOEDIT ] (load only)
[EXEC/NOEXEC ] (load only)
* [EXTERN/WKEXTERN/PSEUDOREG/LABELREF/COMMON/PRIVATE/CSECT] (load)
[FLEVEL/NOFLEVEL ] (load only)
[HASALIAS/NOHASALIAS ]
[ID(Puid)/NOID/NOTID(Puid) ]
* [IDRFULL/NOIDRFULL ] (load only)
* [IOERR/NOIOERR ]
[LKED(Partl) ] (load only)
* [LKEDERR/NOLKEDERR ] (load only)
* [LOADERR/NOLOADERR ] (load only)
[LOADONLY/NOLOADONLY ] (load only)
* [LRECLERR/NOLRECLERR ]
[MODULE({* / Fullm / Partm*)} ] (load only)
* [NAMEERR/NONAMEERR ]
[NULL/NONULL ]
[ORPHAN/NOORPHAN ]
[OVERLAY/NOOVERLAY ] (load only)
*[PACKED/NOPACKED ]
[PAGE/NOPAGE ] (load only)
[REFR/NOREFR ] (load only)
[RENT/NORENT ] (load only)
[REUS/NOREUS ] (load only)
* [RLDERR/NORLDERR ] (load only)
* [RLDZERO/NORLDZERO ] (load only)
[RMODE24/RMODEANY/NORMODE24/NORMODEANY ] (load only)
[SCTR/NOSCTR ] (load only)
* [SPFEDIT/NOSPFEDIT ]
[SSI(hexdata)/SSI/NOSSI/PARTSSI(hexdata) ]
[SYSMOD(Partu) / USERDATA(Partu) ] (load only)
[TTR(Lttr:Httr) ]
[USERDATA(Partu) / SYSMOD(Partu) ] (load only)
[USERID(Puid)/NOUSERID/NOTUSERID(Puid) ]
[VSLKED/NOVSLKED ] (load only)
[ZAP(Partz) ] (load only)
[THEN(ATTRIB / BROWSE / DIRENTRY / DELETE / EDIT /
EXCLUDE / FIND / FSE / HISTORY / LIST /
MAP / MEMBERS / MEMLIST / NEWML / PRINT /
REVIEW / SUBMIT / SUBLIST / TSOEDIT / VERIFY /
VIEW ]
[ELSE(ATTRIB / BROWSE / DIRENTRY / DELETE / EDIT /
EXCLUDE / FIND / FSE / HISTORY / LIST /
MAP / MEMBERS / MEMLIST / NEWML / PRINT /
REVIEW / SUBMIT / SUBLIST / TSOEDIT / VERIFY /
VIEW ]
Aliases
I, IF
Defaults
memgroup, SINCE, THEN(ATTRIB) if neither THEN nor ELSE is entered
Required
none
Operands
memgroup Identifies the members whose attributes are to be examined.
Default member names, member lists, member name
ranges, and member name patterns are allowed; see
Appendix A, "Formatting Member Names".
SINCE Uses dates from the specified date to the current date.
SINCE indicates that the implied date range (TODAY,
YESTERDAY, ... LAST, DATE) follows the date given. For
source modules, the date referenced is the ISPF modification
date; for load modules, it is the linkage edit date.
FROM Uses dates from the specified date to the current date. FROM
indicates that the implied date range (TODAY, YESTERDAY, ...
LAST, DATE) follows the date given. For source modules, the
date referenced is the ISPF modification date; for load
modules, it is the linkage edit date.
BEFORE Uses dates before (and including) the specified date. BEFORE
indicates that the implied date range (TODAY, YESTERDAY, ...
LAST, DATE) is before the given date. For source modules,
the date referenced is the ISPF modification date; for load
modules, it is the linkage edit date.
TO Uses dates before (and including) the specified date. TO
indicates that the implied date range (TODAY, YESTERDAY, ...
LAST, DATE) is before the given date. For source modules,
the date referenced is the ISPF modification date; for load
modules, it is the linkage edit date.
TODAY A date, equivalent to LAST(0).
YESTERDAY A date, equivalent to LAST(1).
WEEK A date, equivalent to LAST(7).
CURRENT A date, equivalent to LAST(10).
BIWEEK A date, equivalent to LAST(14).
MONTH A date, equivalent to LAST(30).
QUARTER A date, equivalent to LAST(120).
HALFYEAR A date, equivalent to LAST(183).
YEAR A date, equivalent to LAST(365).
BIYEAR A date, equivalent to LAST(730).
LAST(numdays) A date indicating the number of days before today.
DATE(cdate) A date indicating the actual date. It can be entered in ISPF
format (yyyy/mm/dd), or Julian format (yyyy.ddd).
CHANGED(date: Searches for members modified by an ISPF editor or a ZAP
program between the dates specified. If only a single date is
entered, only that date is checked but normally a date range
is entered like:
CHANGED(yyyy/mm/dd:yyyy/mm/dd)
Only members with ISPF statistics or members created by a
linkage editor are supported.
LKEDERR Selects modules with any of the following illegal linkage edit
attribute combinations:
Modules with RENT and NOREUS attributes
Modules with RMODEANY and AMODE24 or AMODEANY
attributes
Modules with OVLY and RENT, REUS, REFR, SCTR, RMODEANY,
AMODE31, AMODE64, or AMODEANY attributes
Modules with TEST and NOEDIT attributes
Modules with REUS and SCTR attributes
NOLKEDERR Selects modules with none of the above illegal linkage edit
attribute combinations.
LOADERR Selects modules that ABEND when they are LOADED.
NOLOADERR Selects modules that can be LOADED without errors.
LOADONLY Selects modules marked for LOAD ONLY.
NOLOADONLY Selects modules not marked for LOAD ONLY.
LRECLERR Selects members with any of the following LRECL errors:
BLKSIZE divided by input LRECL not integral (RECFM=F)
Input LRECL exceeding maximum DCB LRECL (RECFM=V)
Input LRECL less than 4 bytes (RECFM=V)
NOLRECLERR Selects members with none of the above LRECL errors.
MODULE(name) Specifies a 1- to 8-byte partial external name that limits
CSECT or ENTRY names for attribute searches. If you enter
this parameter with any TRANS, SYSMOD/USERDATA, or ZAP
keywords, only those CSECTs that satisfy the MODULE
keyword are checked for the other keyword conditions.
The MODULE operand has several valid forms:
MODULE(*) – uses the previous name entered on any
MODULE keyword
MODULE(Fullm) – considers only modules containing a CSECT
or ENTRY named FULLM
MODULE(Partm*) – considers only modules containing a
CSECT or ENTRY named PARTM...
NAMEERR Selects members whose member names are not upper-case
alphanumeric or whose first character is numeric.
NONAMEERR Selects members whose member names are upper-case
alphanumeric and whose first character is not numeric.
NULL Selects members with no data.
NONULL Selects members with some data.
ORPHAN Selects alias members that have no associated main
member.
NOORPHAN Selects main members or alias members that have an
associated main member.
OVERLAY Selects overlay modules.
NOOVERLAY Selects non-overlay modules.
SYSMOD(Partu) Selects modules with user IDR data that matches the partial
name Partu. Partu can be entered as partial IDR data with 1
to 8 characters. If you also enter MODULE(...), the SYSMOD
operand applies only to CSECTs whose names satisfy the
MODULE argument.
TEST Selects modules with the TEST attribute.
NOTEST Selects modules without the TEST attribute.
TRANS(Partt) Selects modules with CSECTS identified as having been
assembled or compiled by the translator defined by the
partial name Partt. Partt can be entered as a partial
translator IDR name with 1 to 10 characters. If you also
enter MODULE(...), the TRANS operand applies only to
CSECTs whose names satisfy the MODULE argument.
TTR(Lttr:Httr) Selects members whose start address is in the specified TTR
range. Lttr defaults to 0 and can be entered as a
hexadecimal TTR value from 0 through FFFFFF. Httr defaults
to FFFFFF and can be entered as a hexadecimal TTR value
from 0 through FFFFFF.
USERDATA(Partu) Selects modules with user IDR data that matches the partial
name Partu. Partu can be entered as partial IDR data with 1
to 8 characters. If you also enter MODULE(...), the
USERDATA operand applies only to CSECTs whose names
satisfy the MODULE argument.
USERID(Puid) Selects members with ISPF statistics and user IDs matching
the partial name Puid. Puid can be entered as a partial TSO
user ID with 1 to 7 characters. USERID is an alias of ID.
NOUSERID Selects members without ISPF statistics. NOUSERID is an
alias of NOID.
NOTUSERID(Puid) Selects members without ISPF statistics or members with
ISPF statistics and user IDs that do not match the partial
name Puid. Puid can be entered as a partial TSO user ID with
1 to 7 characters. NOTUSERID is an alias of NOTID.
VSLKED Selects modules linked by the system linkage editor.
NOVSLKED Selects modules not linked by the system linkage editor.
ZAP(Partz) Selects modules with zap IDR data that matches the partial
name Partz. Partz can be entered as partial zap IDR data
with 1 to 8 characters. If you also enter MODULE(...), the
ZAP operand applies only to CSECTs whose names satisfy the
MODULE argument.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
----------------------- ISPMODE Session Display -------------- ROW 3011 OF 3020
COMMAND ===> LL ===> CSR
- DSN=C911407.LINK.LOAD,VOL=SER=STR804 MEM=: -------------------------------
>----->if : rmodeany then(sublist).
>----->members
PDS165I Members are: ASID, ASIDZN, PDSPGM, WHAT, WHATO
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
----------------------- ISPMODE Session# 2 Log# 1 ------- ROW 735 TO 747 OF 747
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.LIB.CNTL,VOL=SER=SER006 MEM=: ----------------------------------
>----->if : last(15)
PDS230I ISPF Stats: VER.MOD CREATED LAST MODIFIED SIZE INIT MOD ID
PDS230I A 01.00 93/04/08 93/04/08 13:21 5 5 0 SER07
PDS230I ABLK 01.01 93/04/09 93/04/09 14:37 6 9 0 SER07
PDS230I ADOC 01.01 93/04/15 93/04/15 10:17 156 192 0 SER07
PDS230I LOADMARK 01.02 93/02/26 93/04/05 6:43 50 48 0 SER07
PDS230I SAMPSECR 01.26 90/03/27 93/04/16 5:57 197 220 140 SER07
PDS230I TRIAL601 01.00 93/04/14 93/04/14 15:16 123 123 0 SER07
PDS117I 6 members counted; cumulative size from statistics is 537 records
ISPF Subcommand
The ISPF subcommand invokes the ISPF primary panel with any option.
Example
ISPF 3.3
Syntax
ISPF [option]
Aliases
IS, ISP, ISPF
Defaults
none
Required
none
Operands
option Specifies an initial ISPF option (such as 3.3) that allows you to skip
intermediate panel displays.
Remarks
The result of using the ISPF subcommand is a temporary suspension of your StarTool FDM
session and entry to the specified ISPF function. After you terminate ISPF by repeated
ENDs, your StarTool FDM session is activated again. This is a stacked ISPF session.
ISPMODE Function
The ISPMODE subcommand switches StarTool FDM to a full screen session display mode.
Subcommands entered and the outputs from internal StarTool FDM subcommands are
maintained in a log.
Example
ISPMODE
Syntax
ISPMODE
Aliases
ISPM, ISPMO, ISPMOD, ISPMODE
Operands
No operands are supported for the ISPMODE subcommand.
Remarks
The ISPMODE log displays in response to a ISPMODE subcommand issued in line mode.
You then enter ISPMODE (an ISPF dialog mode). After you are in dialog mode, use the
LOG command to select any one of nine different logs for your session display.
When ISPMODE is active, StarTool FDM operates as a normal ISPF dialog. Enter the HELP
command while in ISPMODE to get ISPF tutorial information or enter the INDEX command
to go to the StarTool FDM tutorial index panel directly.
Suspend ISPMODE with the SUSPEND command. SUSPEND places your session into line
mode (for example, you can go into line mode to SEND or RECEIVE data using IND$FILE).
To enter ISPMODE again, type an ISPMODE, ISPXEQ, or MEMLIST subcommand.
ISPXEQ Function
Use the ISPXEQ subcommand to enter StarTool FDM in LISTA or LISTV dialog mode
instead of the usual ISPMODE or MEMLIST mode.
Example
STARTOOL LIB.CNTL ISPXEQ LISTA OPEN
Syntax
ISPXEQ / ISPXEQS {command}
Aliases
ISPX, ISPXE, ISPXEQ, ISPXEQS
Defaults
none
Required
command
Operands
command Specifies a ISPMODE command to be executed after StarTool FDM
initialization.
Remarks
Use the ISPXEQ subcommand in building ISPF command table entries for StarTool FDM
dialog functions. For example, add the following command table entry for an ISPF
command called LA:
SELECT CMD(STARTOOL 'SYS1.HELP' ISPXEQ LISTA &ZPARM)
LIST Subcommand
The LIST subcommand displays data from a member or data set.
Example
LIST mema:memb
Syntax
LIST memgroup [NUM/SNUM/NONUM/LBLOCK/LDUMP/BLOCK/DUMP ]
[OFFSET(Hx) MODULE({* / Fullm / Partm*)} ]
[MAXMEMBERS(num) ]
[FORMAT(from:to,from:to, ...) ]
[SKIPREC(n) MAXIN(n) MAXOUT(n) ]
[SKIPCOL(n) MAXLEN(n) ]
* [FROMKEY(key)/FROMADDRESS(add)/FROMNUMBER(num) ]
* [TOKEY(key)/TOADDRESS(add)/TONUMBER(num) ]
Aliases
LI, LIS, LIST
Abbreviations
FKEY for FROMKEY, FADDR for FROMADDRESS, FNUM for FROMNUMBER, TKEY for TOKEY,
TADDR for TOADDRESS, and TNUM for TONUMBER.
Defaults
memgroup, NUM or previous LIST/FIND/REPLACE format
Required
none
Operands
memgroup Identifies the members to be displayed.
Default member names, member lists, member name ranges,
and member name patterns are allowed; for more
information, see Appendix A, "Formatting Member Names".
NUM Examines the line number field (the last 8 bytes of a fixed-
format record or the first 8 bytes otherwise) of each logical
record. If the field is not numeric, switches formatting to
NONUM mode for the remainder of the member.
For ISPF-saved members, the high-order 6 digits of the line
number field is formatted; otherwise, the low-order 6 digits
of the line number field is formatted by suppressing leading
zeroes. The line number segment is followed by a blank and
up to 249 characters of data from a logical record.
SNUM Discards the line number field (the last 8 bytes for a fixed-
format record or the first 8 otherwise). Displays up to 256
bytes from a logical record.
NONUM Displays up to 256 bytes from a logical record (without
regard to line numbers).
LBLOCK Formats logical records with two hexadecimal offsets
(displacement in the member and displacement in the logical
record) and segments of up to 64 characters surrounded by
asterisks.
For load modules, only CSECT data is displayed. If you enter
a name in a MODULE operand, only those CSECT or ENTRY
names that satisfy the condition display. CSECT records are
formatted with two hexadecimal offsets (a module offset and
a CSECT offset) and segments of up to 64 characters
surrounded by asterisks.
For VSAM records, the first field in the output is the relative
record number for a fixed or variable RRDS. Up to 8 bytes of
the key for a KSDS (if the key is longer than 8 characters, a +
will be placed after the key); otherwise, it is a relative byte
address.
LDUMP Logical records are formatted with two hexadecimal offsets
(displacement in the member and displacement in the logical
record), segments of up to 32 characters of hexadecimal data
and up to 16 bytes of equivalent characters surrounded by
asterisks.
For load modules, only CSECT data displays. If you enter a
name in a MODULE operand, only those CSECT or ENTRY
names that satisfy the condition display. CSECT records are
formatted with two hexadecimal offsets (a module offset and
a CSECT offset), segments of up to 32 characters of
hexadecimal data and up to 16 bytes of characters
surrounded by asterisks.
Also, for VSAM records, the first field in the output is the
relative record number for a fixed or variable RRDS. Up to 8
bytes of the key for a KSDS (if the key is longer than 8
characters, a + will be placed after the key); otherwise, it is a
relative byte address.
Remarks
Unprintable characters for 3270-type devices are translated to periods before they
display.
LIST formats are NUM, SNUM, NONUM, LBLOCK, LDUMP, BLOCK, and DUMP. For load
modules, the NUM, SNUM, and NONUM formats are equivalent to the LDUMP format. For
VSAM data sets, the NUM, SNUM, and NONUM formats are equivalent to the LBLOCK
format.
The default format is initially NUM; however, each time a format operand is entered on a
LIST, FIND, or REPLACE subcommand, the value entered is used as the output format for
subsequent LIST, FIND, and REPLACE subcommands. Also, note the following:
1 Formats NUM, SNUM, and NONUM limit the display length for logical records to 256
characters.
2 Formats BLOCK and DUMP apply to physical records for non-VSAM data sets (or when
control interval processing is being performed). The other formats apply to logical
records. For load modules, LBLOCK and LDUMP formats display only CSECT data.
3 For VSAM DATA or INDEX components, the LIST, FIND, and REPLACE subcommands
support control interval access using the DUMP or BLOCK display formats. Instead of
accessing individual VSAM records, each GET or PUT obtains a VSAM control interval.
Control interval access could be useful if a VSAM data set has logical errors. REPLACE can
repair the error; however, since only the component is opened for update, the next access
of the data set through the related cluster gets warning errors due to the differing time
stamps.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
--------------------- ISPMODE Session Display ----------------- ROW 7 OF 682
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.LINK.LOAD,VOL=SER=STR804 MEM=ZAPHELP -------------------------
>----->list zaphelp off(40c0)
PDS141I AT 003FF0 CSECT CSOUT LENGTH 00000428
0040C0 00D0 45F0C0E4 000040CC 00000000 C9D2D1C4 *.0U.. .....IKJD*
0040D0 00E0 C1C9D940 0A0686FF C03AD207 A090D1A0 *AIR ..f..K...J.*
0040E0 00F0 D703A010 A0104100 A0305000 A008928F *P.........&...k.*
0040F0 0100 A008D25F A030C3A8 D207A058 A0904110 *..Kª..CyK.......*
004100 0110 A0080A13 9110A060 4710C1CA 41F00004 *....j..-..A..0..*
004110 0120 47F0C03A 4110A030 58F01030 45E0F008 *.0......0....*
004120 0130 47F0C1CA 4800A012 95F1A0BF 4780C1D0 *.0A.....n1....A*
004130 0140 95F0A0BF 4780C162 954EA0BF 4780C166 *n0....A.n+....A.*
004140 0150 9560A0BF 4780C160 9240A0BF 47F0C164 *n-....A-k ...0A.*
004150 0160 06000600 06001200 47D0C1D0 4000A012 *.........A ...*
004160 0170 4110A030 4100A0BF 58F01030 05EF9120 *.........0....j.*
004170 0180 A0004780 C1B6D201 A0BEC422 4110A13B *....A.K...D... .*
004180 0190 95401000 4770C19C 4610C190 D2031001 *n ....A...A.K...*
004190 01A0 C41C4100 A0BB1B10 47D0C1B6 4010A0BC *D........A. ...*
0041A0 01B0 4110A0BC 0A239104 A0004780 C1CA94FB *......j.....A.m.*
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS EATURES
----------------- ISPMODE Session# 2 Log ---------- ROW 1,000 TO 1,017 F 1,176
COMMAND ===> SCROLL ==> CSR
- DSN=SER07.LIB.CLISTV,VOL=SER=SER006 MEM=CLI* -----------------------------
>----->list cli*
** LIST CLIST
/* THE FOLLOWING CLIST WILL ESTABLISH AN ALTLIB FOR CLIST TESTING */
/* */
PROC 1 DSNAME
ALTLIB ACT APP(CLIST) DSN(&DSNAME)
WRITE &DSNAME IS A NEW CLIST LIBRARY FOR TESTING
PDS142I 5 lines in this member
** LIST CLISTDSP
000100 PROC 2 DSN MEM VOL(VOLSER)
000200 ISPEXEC DISPLAY PANEL(&MEM.)
PDS142I 2 lines in this member
** LIST CLISTSOE
PROC 0
CONTROL MAIN
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
----------------- ISPMODE Session# 1 Log -------- ROW 1,000 TO 1,016 OF 1,016
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.LINK.LOAD,VOL=SER=SER007 MEM=IEFBR14 ---------------------------
>----->list iefbr14 dump skiprec(3)
PDS140I DUMP RECORD 4 LENGTH 21 TTR 00120D
000135 0000 80140480 0200F5F7 F3F4C1E2 F1F0F040 *......5734AS100 *
000145 0010 06018124 0F *..a..*
FUNCTIONS CONTROL DSN CMDS DATA CMDS A-M DATA CMDS N-Z DEFAULT FEATURE
----------------- ISPMODE Session# 1 Log# 1 --------- ROW 131 TO 156 OF 261
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.VSAM.RV.CLUSTER,VOL=SER=SER007 ----------------------------------
>----->list block
PDS140I BLOCK RECORD 1 LENGTH 29 RBA 00000004
0000001 0000 *0000XX00 SET ZCTVERB = PDSSX*
FUNCTIONS CONTROL DSN CMDS DATA CMDS A-M DATA CMDS N-Z DEFAULT FEATURE
-------------------- ISPMODE Session# 1 Log# 1 ------ ROW 675 TO 700 OF 1,075
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.VSAM.IS.CLUSTER,VOL=SER=SER007 ----------------------------------
>----->list block skiprec(21)
PDS140I BLOCK RECORD 22 LENGTH 80 RBA 00001484
00000600 000 *00000600A004E /* SECONDARY OF THE REQUESTED SIZE FOR DATA S*
00000600 040 *ETS */ *
LISTA Function
LA or LISTA command displays your TSO session allocations in an ISPF table. DDNAME is
another way to use the LISTA table. The LISTA/DDNAME table is maintained in DDNAME
and concatenation order (the SORT command is not supported).
Example
LISTA open old mod
Syntax
LISTA [ALL ]
[OPEN ]
[UNOPEN/CLOSED ]
[CONCAT/CATENATE ]
[NONCAT/NONCON ]
[DUMMY/NULLFILE ]
[ ]
[TERMINAL ]
[JESFILE/SYSOUT ]
[TMP/TEMPORY ]
[NEW MOD SHR OLD ]
[TASKLIB ]
[SETDEF ]
[RESET ]
Aliases
LA, LISTA
Defaults
ALL
Required
none
Operands
ALL Selects all allocations (initial default).
OPEN Selects open allocations.
UNOPEN Selects closed allocations.
CLOSED Selects closed allocations.
CONCAT Selects allocations that are a part of a concatenation.
CATENATE Selects allocations that are a part of a concatenation.
NONCAT Selects allocations that are not concatenated.
NONCON Selects allocations that are not concatenated.
DUMMY Selects NULLFILE allocations.
NULLFILE Selects NULLFILE allocations.
Selects NULLFILE allocations that are not also TERMINAL.
TERMINAL Selects TERMINAL allocations.
Remarks
The LISTA/DDNAME ISPF table displays in response to a LISTA command. When you are
in a LISTA/DDNAME display, you can delete a part of the table, find data in the table, print
a part of the table, store a part of the table in a data set, etc. For assistance with the
different options available, use the HELP command, CUA functions, or enter an O
command as either a primary command or as a line command.
LISTA has alternate panels, as do most of the ISPMODE tables in StarTool FDM, containing
extra information about the listed data sets. The first LISTA/DDNAME panel shows basic
allocation information such as DDNAME, data set TYPE, Open count (under the header
O#), VOLUME allocated, MEMBER name, and DSNAME. Command error messages are
provided under the DATA/MSG header as follows:
TYPE is the data set DSORG or VIO, CTLG, VVDS, JES, or TERM depending on the type of
allocation.
The second LISTA/DDNAME panel is a double line panel that includes some additional
information: DISP for data set disposition and STAT for data set status. The STAT field is
TMP for temporary, PRM for permanent, or CNV for convertible.
The following primary commands are supported directly for the LISTA/DDNAME function.
For information on ISPMODE commands available in StarTool FDM, see “Common
Commands” in Chapter 2, "ISPF Interface Commands".
BAT[CHJCL] Builds batch JCL that includes all DD statements in the LISTA table.
COMPR[ESS] Global command. Changes to each data set in the table and issues a
COMPRESS subcommand.
Syntax COMPRESS [LIST/NOLIST/SUMMARY]
FI[ND] Global command. Changes to each data set in the table and issues a
FIND subcommand. Since the syntax entered on a FIND
subcommand is applied to each data set individually, do not attempt
to search mixed partitioned and non-partitioned data sets with a
single FIND global command.
Syntax
FIND memgroup 'anystring'
[NUM/SNUM/NONUM/LBLOCK/LDUMP/BLOCK/DUMP]
[CAPS/ASIS/IGNORE] [WORD/PREFIX/SUFFIX]
GL[OBAL] Global command. Changes to each data set in the table and issues a
StarTool FDM subcommand.
Syntax GLOBAL anysubcommand [anyoperands]
MODEL Global command. Changes to each data set in the table and issues a
MODEL command.
NOR[MAL] Displays the default view of the LISTA/DDNAME table.
OUT[PUT] Outputs the LISTA/DDNAME table to print or a data set.
Syntax OUTPUT [=c / F(ddname)]
REPL[ACE] Global command. Changes to each data set in the table and issues a
REPLACE subcommand. Since the syntax entered on a REPLACE
subcommand is applied to each data set individually, do not attempt
to update mixed partitioned and non-partitioned data sets with a
single REPLACE global command.
Syntax
REPLACE memgroup 'fromstring' 'tostring'
[NUM/SNUM/NONUM/LBLOCK/LDUMP/BLOCK/DUMP]
[CAPS/ASIS/IGNORE] [WORD/PREFIX/SUFFIX]
[WRITE/NOWRITE]
RESET Often used with data set tagging, clears the DATA/MSG field in all
table entries.
RF[IND] Finds a string (repeat find) and positions the display start location.
PF keys 5 and 17 are normally set to RFIND.
RI[GHT] Rotates through alternate views of the LISTA/DDNAME table. PF keys
11 and 23 are normally set to RIGHT.
SEEK Global command. Changes to each data set in the table and looks for
a member.
Syntax SEEK member
TAG Applies the specified line command to table entries marked with
*TAG* in the DATA/MSG field and executes each entry.
Syntax TAG linecmd
Block line commands are doubled letters that delimit a range of table entries for which the
same action is to be performed. The following block line commands are supported in the
LISTA/DDNAME function:
== = command. Repeats the previous line command for the range of lines.
*cm ERR- t=”Block line command,==”>
FUNCTIONS CTL A-M CTL N-Z LINE CMDS A-M LINE CMDS N-Z DEFAULTS FEATURE
----------------------- List Allocations ----------------- ROW 1 TO 7 OF 39
COMMAND ===> SCROLL ==> CSR
- DSN=SER07.LIB.CLISTV,VOL=SER=SER006 MEM=/AXI -----------------------------
CMD DDNAME DATA/MSG I/O's O# VOLUME MEMBER ------ DATA SET NAME --------
STEPLIB 34 1 SER007 SER07.LINK.LOAD
# 2 0 1 SER007 SER09.SDS.LOAD
# 3 0 1 SER007 SER.COMPAREX.LINKLIB
ISPPLIB 195 1 SER006 SER07.LIB.PDSE
# 2 2 1 SER007 SER.COMPAREX.PANELS
# 3 0 1 TSG303 SYSI.IBMPDF.SYS350.PREPLIB
# 4 27 1 TSG302 SYSI.IBMPDF.SYS350.ISRENU
# 5 0 1 TSG309 SYSI.IBMPDF.SYS350.ISPENU
# 6 0 1 TSG301 SYSP.CUST.ISPPLIB
ISPMLIB 4 1 SER006 SER07.LIB.PDSE
o # 2 0 1 SER007 SER.COMPAREX.MSGS
# 3 3 1 TSG302 SYSI.IBMPDF.SYS350.ISRENU
# 4 99 1 TSG309 SYSI.IBMPDF.SYS350.ISPENU
# 5 0 1 TSG301 SYSP.STD.ISPMLIB
ISPSLIB 0 1 TSG301 SYSP.STD.ISPSLIB
# 2 0 1 TSG302 SYSI.IBMPDF.SYS350.ISRENU
ISPTLIB 1 1 TSG301 SYSP.STD.ISPTLIB
LISTC Function
Use the LC or LISTC command to display data sets from a catalog source in an ISPF table.
The table displaying LISTC data sets is combined with LISTF data sets.
LISTC/LISTF tables can be saved permanently. They are saved in the ISPF profile data set
by default (ISPPROF) but the DDNAME can be changed in the SETALL option. To manage
these tables, use the SAVE, ID, MERGE, NOSAVE, and ERASE commands. To automatically
save these tables at program end or when a new LISTC/LISTF table is retrieved, check the
setting of “Automatic save” in SETALL for LISTC/LISTF.
Saved LISTC/LISTF tables are given members names of the form PDSLF0na if the name is
one or two numeric digits; otherwise, a name of the form ##name is used where name is
a 1- to 6-character alphanumeric table identification name.
The FIND and REPLACE global subcommands bypass non-partitioned data sets. If you
want to search or update non-partitioned data sets, use GLOBAL followed by FIND or
REPLACE and any operands.
In the LISTC prompt panel, enter the LEVEL/DSN field as a partial data set name. The first
level can contain an * after one or more characters and any additional levels can contain
an * before or after any characters in that level. For example: SYS*.NU*.*.*XY
Due to a restriction in the SUPERLOCATE service, generic searches for GDG data sets
must contain an * in the first position of the GDG data set node. For example, if you
search for NODE1.GDG.G00*, no GDG entries will be found. However, you can find these
entries by changing the search to NODE1.GDG.*G00.
You can bypass the LISTC or LISTF prompting panels by using the MASK command. See
“MASK Function”.
Example
LISTC
Syntax
LISTC [name] [RESET] [PROMPT]
Aliases
LC, LISTC
Defaults
none – add to the LISTC/LISTF table
Required
none
Operands
name 1- to 6-alphanumeric characters, the LISTC/LISTF table name to retrieve.
RESET Clears the LISTC/LISTF table before adding any new entries.
PROMPT Prompts for LISTC operands even if a LISTC/LISTF table exists.
Remarks
The LISTC/LISTF ISPF table displays in response to a LISTC command. When you are in a
LISTC display, you can delete a part of the table, sort the data in different directions, find
data in the table, print a part of the table, store a part of the table in a data set, etc. For
assistance with the different options available, use the HELP command, CUA functions, or
you enter an O command as either a primary command or as a line command.
There are ten defined formats for LISTC/LISTF. Select which panels you want to use with
the SETPANEL command as shown below. You can switch between these panel formats
with RIGHT and LEFT commands. Following this panel is a sample of each of the ten
defined panel formats. StarTool FDM displays DSORG (under header DO) as DA for direct,
PE for partitioned extended, PO for partitioned, PS for sequential, and VS for VSAM.
Each of the panels contain a column of data under the C (for Catalog) header which is Y if
the data set is cataloged, N if the data set is not cataloged, and - if the data set catalog
status was not checked.
The column of data under the V (for Volume) header provides feedback as to whether or
not the data set is present on the volume. Y and N are short for YES or NO, M is short for
Managed (meaning that it is a SMS data set), and - means that the status of the data set
was not checked.
The following primary commands are supported directly for the LISTC function. For
information on ISPMODE commands available in StarTool FDM, see “Common Commands”
in Chapter 2, "ISPF Interface Commands".
COMPR[ESS] Global command. Changes to each data set in the table and issues a
COMPRESS subcommand.
In LISTC/LISTF tables, non-partitioned data sets are skipped.
Syntax COMPRESS [LIST/NOLIST/SUMMARY]
Syntax
F anystring [ASIS]
[FIRST/LAST/PREV] [PREFIX/SUFFIX/WORD]
[ANY/DSNAME/VOLUME/DO/RECFM/CDATE/ RDATE]
FI[ND] Global command. Changes to each table data set and issues a FIND
subcommand. In LISTC/LISTF tables, non-partitioned data sets are
skipped.
Syntax
FIND memgroup 'anystring'
[NUM/SNUM/NONUM/LBLOCK/LDUMP/BLOCK/DUMP]
[CAPS/ASIS/IGNORE] [WORD/PREFIX/SUFFIX]
GL[OBAL] Global command. Changes to each data set in the table and issues a
StarTool FDM subcommand.
Syntax GLOBAL anysubcommand [anyoperands]
MER[GE] Merges data from a saved LISTC/LISTF table into the current table.
Syntax MERGE name [GROUP/SAMPLE] [RESET]
REF[RESH] Global command. Updates information and status for all lines in the
LISTC/LISTF table. Also, REFRESH corrects volume name entries for
cataloged data sets.
REM[OVE] Trims the LISTC/LISTF table based on a string match.
Syntax
REMOVE anystring [PREFIX/SUFFIX/WORD] [NOT]
[ANY/DSNAME/VOLUME/DO/RECFM/CDATE/RDATE]
REPL[ACE] Global command. Changes to each data set in the table and issues a
REPLACE subcommand. In LISTC/LISTF tables, non-partitioned data
sets are skipped.
Syntax
REPLACE memgroup 'fromstring' 'tostring'
[NUM/SNUM/NONUM/LBLOCK/LDUMP/BLOCK/DUMP]
[CAPS/ASIS/IGNORE] [WORD/PREFIX/SUFFIX]
[WRITE/NOWRITE]
RESET Often used with data set tagging, clears the DATA/MSG field in all
table entries.
RF[IND] Finds a string (repeat find) and positions the display start location.
PF keys 5 and 17 are normally set to RFIND.
RI[GHT] Rotates through alternate views of the LISTC/LISTF table. PF keys
11 and 23 are normally set to RIGHT.
SAVE Creates a permanent table for use in a different StarTool FDM
session.
Syntax SAVE [name] [REPLACE/NOREPL]
SO[RT] Sorts function tables into an alternate order. SORT with no operands
sorts the table in default order, while SORT with a field name sorts
the table in that order.
Syntax SORT [DSNAME/VOLUME/CDATE/RDATE/SIZE/FREE
/EXTENTS/BLKSIZE/TYPE/ALLOC]
[ASCEND/DESCEND]
TAG Applies the specified line command to table entries marked with
*TAG* in the DATA/MSG field and executes each entry.
Syntax TAG linecmd
The following line commands are supported in the LISTC function – note that the DFHSM
commands are supported from the UT panel.
Block line commands are doubled letters that delimit a range of table entries for which the
same action is to be performed. The following block line commands are supported in the
LISTC function:
== = command. Repeats the previous line command for the range of lines.
*cm ERR- t=”Block line command,==”>
LISTF Function
Use the LF or LISTF command to display data sets from a volume or VTOC source in an
ISPF table. The table displaying LISTF data sets is combined with LISTC data sets.
LISTC/LISTF tables can be saved permanently. They are saved in the ISPF profile data set
by default (ISPPROF) but the DDNAME can be changed in the SETALL option. To manage
these tables, use the SAVE, ID, MERGE, NOSAVE, and ERASE commands. To automatically
save these tables at program end or when a new LISTC/LISTF table is retrieved, check the
setting of “Automatic save” in SETALL for LISTC/LISTF.
Saved LISTC/LISTF tables are given member names of the form PDSLF0na if the name is
one or two numeric digits; otherwise, use a name of the form ##name where name is a
1- to 6-character alphanumeric table identification name.
In the LISTF prompt panel, enter a volume mask in the search field and the LEVEL/DSN
field as a partial data set name. For the LISTF volume mask, use a / may for a pattern
specification. Use an * for a combination name, and use a : for a range. For example:
TSO/03, TSO*, and TSO:TSO80. For the data set name, each level can contain an *
before or after any characters in that level. For example: SYS*.NU*.*.*XY.
You can bypass the LISTC or LISTF prompting panels by using the MASK command. See
“MASK Function”.
Example
LISTF
Syntax
LISTF [name] [RESET] [PROMPT]
Aliases
LF, LISTF
Defaults
none—add to the LISTC/LISTF table
Required
none
Operands
name 1- to 6-alphanumeric characters, the LISTC/LISTF table name to retrieve.
RESET Clears the LISTC/LISTF table before adding any new entries.
PROMPT Prompts for LISTF operands even if a LISTC/LISTF table exists.
Remarks
The LISTF/LISTC ISPF table displays in response to a LISTF command. When you are in a
LISTF display, you can delete a part of the table, sort the data in different directions, find
data in the table, print a part of the table, store a part of the table in a data set, etc. For
assistance with the different options available, use the HELP command, CUA functions, or
enter an O command as either a primary command or as a line command.
There are ten defined formats for LISTC/LISTF. Select which panels you want to use with
the SETPANEL command, as shown below. You can switch between these panel formats
with RIGHT and LEFT commands. Following this panel is a sample of each of the ten
defined panel formats. StarTool FDM displays DSORG (under header DO) as DA for direct,
PE for partitioned extended, PO for partitioned, PS for sequential, and VS for VSAM.
Each of the panels contain a column of data under the C (for Catalog) header which is Y if
the data set is cataloged, N if the data set is not cataloged, and - if catalog status was not
checked.
The column of data under the V (for Volume) header provides feedback as to whether or
not the data set is present on the volume. Y and N are short for YES or NO, M is short for
Managed (meaning that it is a SMS data set), and - means that the status of the data set
was not checked.
The following primary commands are supported directly for the LISTF function; for
information on ISPMODE commands available in StarTool FDM, see “Common Commands”
in Chapter 2, "ISPF Interface Commands".
COMPR[ESS] Global command. Changes to each data set in the table and issues a
COMPRESS subcommand. In LISTC/LISTF tables, non-partitioned
data sets are skipped.
Syntax COMPRESS [LIST/NOLIST/SUMMARY]
FI[ND] Global command. Changes to each table data set and issues a FIND
subcommand. In LISTC/LISTF tables, non-partitioned data sets are
skipped.
Syntax FIND memgroup 'anystring'
[NUM/SNUM/NONUM/LBLOCK/LDUMP/BLOCK/DUMP]
[CAPS/ASIS/IGNORE] [WORD/PREFIX/SUFFIX]
GL[OBAL] Global command. Changes to each data set in the table and issues a
StarTool FDM subcommand.
Syntax GLOBAL anysubcommand [anyoperands]
REF[RESH] Global command. Updates information and status for all lines in the
LISTC/LISTF table. Also, REFRESH corrects volume name entries for
cataloged data sets.
REM[OVE] Trims the LISTC/LISTF table based on a string match.
Syntax
REMOVE anystring [PREFIX/SUFFIX/WORD] [NOT]
[ANY/DSNAME/VOLUME/DO/RECFM/CDATE/RDATE]
REPL[ACE] Global command. Changes to each data set in the table and issues a
REPLACE command. In LISTC/LISTF tables, non-partitioned data
sets are skipped.
Syntax
REPLACE memgroup 'fromstring' 'tostring'
[NUM/SNUM/NONUM/LBLOCK/LDUMP/BLOCK/DUMP]
[CAPS/ASIS/IGNORE] [WORD/PREFIX/SUFFIX]
[WRITE/NOWRITE]
RESET Often used with data set tagging, clears the DATA/MSG field in all
table entries.
RF[IND] Finds a string (repeat find) and positions the display start location.
PF keys 5 and 17 are normally set to RFIND.
RI[GHT] Rotates through alternate views of the LISTC/LISTF table. PF keys
11 and 23 are normally set to RIGHT.
SAVE Creates a permanent table for use in a different StarTool FDM
session.
Syntax SAVE [name] [REPLACE/NOREPL]
SO[RT] Sorts function tables into an alternate order. SORT with no operands
sorts the table in default order, while SORT with a field name sorts
the table in that order.
Syntax SORT [DSNAME/VOLUME/CDATE/RDATE/SIZE/FREE
/EXTENTS/BLKSIZE/TYPE/ALLOC]
[ASCEND/DESCEND]
TAG Applies the specified line command to table entries marked with
*TAG* in the DATA/MSG field and executes each entry.
Syntax TAG linecmd
The following line commands are supported in the LISTF function – note that the DFHSM
commands are supported from the UT panel.
Block line commands are doubled letters that delimit a range of table entries for which the
same action is to be performed. The following block line commands are supported in the
LISTF function:
== = command. Repeats the previous line command for the range of lines.
*cm ERR-t=”Block line command,==”>
LISTGRP Subcommand
The LISTGRP subcommand lists the member group specifications for the current member
group.
LISTGRP lists only the names of the member groups; it does not list member names.
Example
LISTGRP
Syntax
LISTGRP
Aliases
LISTG, LISTGR, LISTGRP
Defaults
none
Required
none
Operands
none
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------------------------------------------------------------
-------------------------- ISPMODE Session# 1 Log# 1 ------------ ROW 1 OF 15
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.PDSE112.CLIST,VOL=SER=SER002 MEM=(ADD* -------------------------
>----->AT (add*,cut/,jcl/)
PDS230I ISPF Stats: VER.MOD CREATED LAST MODIFIED SIZE INIT MOD ID
PDS230I ADDCYL 01.00 93/05/07 93/05/07 7:55 42 42 0 SER07
PDS230I ADDDIR 01.02 93/05/07 93/05/07 8:45 48 48 3 SER07
PDS230I ADDTRK 01.03 93/05/07 93/05/07 8:27 42 42 4 SER07
PDS230I CUT 01.00 93/06/07 93/06/07 9:29 160 160 0 SER07
PDS230I CUTJCL 01.22 93/06/18 93/06/20 6:53 179 168 0 SER09
PDS230I $PDSWJCL 01.02 93/06/18 93/06/19 9:05 24 17 0 SER09
PDS230I CUTJCL 01.22 93/06/18 93/06/20 6:53 179 168 0 SER09
PDS117I 7 members counted; cumulative size is 674 records
>----->listgrp
MEM (ADD*
CUT/
JCL/)
******************************* BOTTOM OF DATA ***********************************
LISTV Function
The LV or LISTV command displays disk volume space usage in an ISPF table.
Example
LISTV stor:stor03
Syntax
LISTV mask [RESET] [ADDR/GENERIC]
Aliases
LV, LISTV
Defaults
none – add to the LISTV table
Required
none
Operands
mask If ADDR or GENERIC do not follow this parameter, displays all volumes
that match the volume mask (mask may contain 1 to 6 characters. An *
or : can display all volumes.Use a / for a pattern specification. Use an *
for a combination name. Use a : for a range. For example:
TSO/03,TSO*,TSO:TSO80.
RESET Clears the LISTV table before adding any new entries.
ADDR Displays all volumes that match the partial UCB address (name can
contain 1 to 3 characters). For example: 0C
GENERIC Displays all volumes that map to the system UNITNAME (name can
contain 1 to 8 characters). For example: SYSDA.
STGGRP Displays volumes that match the SMS storage group specified.
Remarks
The LISTV ISPF table displays in response to a LISTV command. When you are in a LISTV
display, you can delete a part of the table, sort the data in different directions, find data in
the table, print a part of the table, store a part of the table in a data set, etc. For
assistance with the different options available, use the HELP command, CUA functions, or
enter an O command as either a primary command or as a line command.
There are five defined formats for LISTV. You can select which panels you want to use with
the SETPANEL command, as shown below. You can switch between these panel formats
with RIGHT and LEFT commands. Following this panel is a sample of each of the defined
formats.
The Attributes LISTV panel shows basic volume space information and volume name,
device address and type, the mount attributes (PRIV, PUB, or STOR), the volume use
count and several status indicators for the volume under the header STAT-INDC:
The DATA/MSG field is set to *VTOCERR if the VTOC cannot be input or *RESRV if the
volume is reserved. The VTOC Size panel shows VTOC information for systems
programmers. This includes mount attributes (PRIV, PUB, or STOR), mount status (RESV,
PRES, or SYSRes), storage group name (for SMS-managed volumes), the volume use
count (note that it is displayed as *** if it goes over 999), the VTOC CCHH address, VTOC
size in tracks, free DSCB count, and free VIR count.
The following primary commands are supported directly for the LISTV function; for
information on ISPMODE commands available in StarTool FDM, see “Common Commands”
in Chapter 2, "ISPF Interface Commands".
ADD Adds data sets to the LISTF table for all volumes in the LISTV table
without prompting.
ALT[ERNAT] Displays an alternate view of the LISTV table.
APP[LY] Applies the specified line command to all table entries and executes
each entry.
Syntax APPLY linecmd
LE[FT] Rotates through alternate views of the LISTV table. PF keys 10 and
22 are normally set to LEFT.
LISTV Prompts for LISTV parameters and adds additional volumes to the
LISTV table.
Syntax LISTV [mask] [RESET] [ADDR/GENERIC]
LISTVT[OC] Adds data sets to the LISTF table for all volumes in the LISTV table
after a prompt.
L[OCATE] Positions to a data line in sorted tables by searching the current
sorted column for the specified data.
Syntax
LOCATE pvolume/pucb/totalfree/largestfree/attrib
REF[RESH] Updates information and status for all lines in the table.
REM[OVE] Trims the LISTV table based on a string match.
Syntax REMOVE anystring [PREFIX/SUFFIX/WORD] [NOT]
[ANY/VOLUME/ADDRESS]
RF[IND] Finds a string (repeat find) and positions the display start location.
PF keys 5 and 17 are normally set to RFIND.
RI[GHT] Rotates through alternate views of the LISTV table. PF keys 11 and
23 are normally set to RIGHT.
SO[RT] Sorts function tables into an alternate order. SORT with no operands
sorts the table in default order, while SORT with a field name sorts
the table in that order.
Syntax SORT [VOLUME/ADDRESS/ATTR/TYPE/SPACE/LARGEST]
[ASCEND/DESCEND]
SPA[CE] Updates volume space statistics for each volume in the LISTV table.
STATS Updates volume attributes for each volume in the LISTV table.
TAG Applies the specified line command to table entries marked with
*TAG* in the DATA/MSG field and executes each entry.
Syntax TAG linecmd
ADD Adds data sets to the LISTF table for this volume with no prompting.
DIRF Tailors batch JCL to set the DIRF bit on for this volume.
INDX Tailors batch JCL to reverse the indexed VTOC status for this volume (an
OS/VTOC will be switched to an indexed status and an indexed volume will
be switched to an OS/VTOC).
K Kills and clears all following line commands.
LF Invokes LISTF to do a VTOC search on this volume after prompting.
LFEX Invokes LISTF to do a VTOC search on this volume with no prompting.
LIST Adds data sets to the LISTF table for this volume after prompting.
LOG Copies the line into the log.
M Provides line command selection and entry assistance.
O Provides line command selection and operand syntax assistance.
REFR Updates volume space and attributes for this volume.
S Select line command (normally SPAC, it is set by SETSEL).
SPAC Refreshes space data and statistics for this volume.
STAT Refreshes statistics for this volume.
TAG Mark this table entry with *TAG* in the DATA/MSG field.
UT Select the extended user line command panel.
VMAP Invokes the VMAP function on this volume.
VTOC Invokes the TSO VTOC command to display volume contents in the log.
VUSE Invokes the VUSE subcommand on this volume.
X Drops the table line.
Block line commands are doubled letters which delimit a range of table entries for which
the same action is to be performed. The following block line commands are supported in
the LISTV function:
== = command. Repeats the previous line command for the range of lines.
LL LOG command. Copies the range of lines into the log.
OO O command. Provides line command assistance for each line.
SS S command. Selects each line in the range of table lines.
XX X command. Drops the range of table lines.
+-----------------+
| TOTAL= 1 |
| --------------- |
| ADDS = 1 |
| USED = 51% |
| TOTAL FREE |
| CYLS = 1587 |
+-----------------+
LLA Subcommand
The LLA subcommand selectively refreshes member directory entries in LLA-managed
data sets. If a member is not present in the data set, the LLA subcommand removes that
member from LLA management.
Example
LLA isr*
Syntax
LLA memgroup [ALIAS/NOALIAS]
[FORCE ]
[SYNC ]
Aliases
LLA
Defaults
memgroup, ALIAS
Required
none
Operands
memgroup The name of the modules for which the LLA entry is to be refreshed or
removed.
Default member names, member lists, member name ranges, and
member name patterns are allowed; for more information, see
Appendix A, "Formatting Member Names".
ALIAS Any associated members (aliases, apparent aliases, and associated
main members) are also to be refreshed in the LLA directory with
LLACOPY.
NOALIAS Only the named members are to be refreshed or removed from the LLA
directory with LLACOPY.
FORCE The LLACOPY is to be performed even if StarTool FDM indicates the data
set is not LLA-managed. For example, if PARMLIB member CSVLLAxx
indicates GET_LIB_ENQ(NO). If this parameter is used and the data set
is not managed, a BLDL is performed by the operating system instead of
an LLACOPY.
SYNC Members that are not synchronized with their directory entries are to be
selectively refreshed. SYNC can update only changed members in a
library thereby saving resources required to needlessly stage members.
SYNC processing is only available for LLA-managed, LINKLIST data sets
because a system BLDL is used to determine a member’s LLA status.
Therefore, this routine cannot determine the LLA status of any members
that are also in a TASKLIB data set.
NOTE SYNC processing compares directory entries provided by LLA
against directory entries from disk to determine if members are
synchronized. This type of check cannot detect a zap or update in
place.
Remarks
Internally, the LLA subcommand issues an LLACOPY macro to refresh LLA entries.
LLACOPY does not refresh LLA if:
The current data set is not managed by LLA
LLA is not active; there is no LLA directory to update
System level does not support LLA
When you first enter an LLA managed library with StarTool FDM or you request a USAGE
subcommand, you should get the feedback message:
If you attempt to use the LLA subcommand and LLA is not active or the data set is not
managed by LLA, you should get the error message:
If the operating system level does not support LLA, LLACOPY returns codes associated
with BLDL. That is, a member that is present gets a message saying the LLA entry was
refreshed. A member that is not present gets a message saying the LLA entry was
removed.
If you are planning to rename members of an LLA controlled data set, set “Remove
renamed members” in SETALL for MEMLIST to NO. Then, after a member is renamed with
the REN line command, enter an LLA line command on both the old and new member
names to inform LLA of their status changes. After the LLA subcommands finish, remove
the old member name with an X line command.
If you are planning to delete members of an LLA controlled data set, set “Remove deleted
members” in SETALL for MEMLIST to NO. Then, after a member is deleted with the DEL
line command, enter an LLA line command on the deleted member name to inform LLA
that the member has been deleted from the data set. After the LLA subcommand finishes,
you can remove the deleted member with an X line command.
LOG Function
The LOG command displays the current or one of nine session logs. LOG table 1 is the
default. It is the table displayed when dialog mode is first started.
Example
LOG
Syntax
LOG [num] [RESET] [NODISPL]
Aliases
LO, LOG, 8
Defaults
1 initially; otherwise, the current log table.
Required
none
Operands
num Identifies the log table desired (1 through 9).
RESET Empties the selected log table and initializes it with the PDS300I default
message.
NODISPL Sets the LOG function to use the selected numbered session log;
however, it does not cause a switch from the current function. RESET and
NODISPL are often used together to clear a log table without transiting to
the nullified log table.
Remarks
The ISPMODE, ISPXEQ, or MEMLIST subcommand is used to first enter dialog mode. After
you are in dialog mode, use the LOG command to display any one of nine log tables.
The log is displayed in response to a LOG command or to display the output from a
subcommand. When you are in the log table, you can delete a part of the log, find data in
the log, print a part of the log, store a part of the log in a data set, etc. For assistance with
the different options, use the HELP command, CUA functions, or enter an O command as
a primary command.
In the following, LOG session processing is described in more detail. The PUTLINE and
PUTGET routines are monitored for data.
When the PUTLINE routine is entered, the dialog adds another log table entry.
If an output checkpoint is reached for a subcommand (by default, 250 output lines as
set by SETALL for the LOG), ISPMODE positions the log table display to the beginning
of the output of this subcommand and allows you to continue or terminate. You must
respond to this screen before you can enter any StarTool FDM subcommands. Some
useful commands in this situation are:
respond to these messages. You cannot enter other StarTool FDM subcommands.
Some useful commands in this situation are:
When the PUTGET routine is entered, the dialog positions the log display to the
beginning of the output of the just completed subcommand. Enter any type of
subcommand or command at this time.
The following primary commands are supported in the LOG function. For documentation
on ISPMODE commands available anywhere, see “Common Commands” in Chapter 2,
"ISPF Interface Commands".
NO After a required reply, specifies that StarTool FDM not complete the
current action. A YES response allows the process to continue. For
a RESTORE subcommand, enter CAN to terminate RESTORE
processing.
NOR[MAL] Displays the default view of the log table.
O[PTIONS] Provides primary command selection for the log function and
operand syntax assistance.
OUT[PUT] Outputs the log table to print or a data set.
Syntax OUTPUT [=c / F(ddname)]
RCH[ANGE] Captures the command or data set name under the cursor in the
log for modification and/or reuse. PF keys 6 and 18 are normally
set to RCHANGE.
RF[IND] Finds a string (repeat find). Resets the display start location and
positions the cursor over the string. PF keys 5 and 17 are normally
set to RFIND.
RI[GHT] Rotates through alternate views of the log table. PF keys 11 and 23
are normally set to RIGHT.
S[ELECT] BROWSEs load members and EDITs source members. The value
used for the command is set in SETSEL.
Syntax SELECT member
2 Echoed subcommand lines are identified with >------> before the subcommand.
Continuation lines are identified by a - character in the first log position.
3 The F command is a log search command and not the StarTool FDM FIND
subcommand. If you want the FIND subcommand, enter FI, FIN, or FIND.
4 Subcommand names PRINT, HELP, and TSO are intercepted by ISPF. To use the
StarTool FDM subcommands with the same names, use an abbreviated name such as
PRI, HE, or TS.
6 If a StarTool FDM subcommand is too long for the 48 character command field, enter
the first 47 or less characters followed by a + to indicate that more data is required. A
continuation panel with more room for operand entry displays.
7 The END command does not work as in StarTool FDM line mode. END terminates the
current function. Multiple END commands are normally required to terminate the
StarTool FDM command. Use the QUIT subcommand to terminate StarTool FDM.
>------>change lib.cntls
PDS200I DISP UNIT OPT RECFM LRECL BLKSIZE ALLOCTRK FREETRK SECONDARY FREEDIR
PDS200I SHR 3380 C FB 80 32720 1X 10 5 10 TRK 6
PDS200I DISP UNIT OPT RECFM LRECL BLKSIZE ALLOCTRK FREETRK SECONDARY FREEDIR
PDS200I SHR 3380 C FB 80 32720 1X 10 8 10 TRK 6
FUNCTIONS CONTROL DSN CMDS DATA CMDS A-M DATA CMDS N-Z DEFAULT FEATURE
------------------------------------------------------------------------------
-------------------------- ISPMODE Session# 1 Log ROW 1,000 TO 1,009 OF 1,009
COMMAND ===> ut SCROLL ===> CSR
- DSN=C911407.LIB.TEST,VOL=SER=STR815 MEM=ANY/ ----------------------------- -
IDC0509I INDEX ALLOCATION STATUS FOR VOLUME SER007 IS 0
>------>DEFINE CLUSTER ( NAME(SER07.VSAM.T.CLUSTER) INDEXED VOL(SER007) RECORD
-SIZE(200 9000) SPANNED KEYS(8 0) ERASE NORECATAL
-OG NOREPLICATE NOREUSE NOIMBED SPEED WRITECHECK BUFFERSPACE(40000) FREESPACE(
-33 15) SHAREOPTIONS(2 3)) DATA ( TRACKS(1 1
-) CISZ(4096) ) INDEX ( TRACKS(1 1) CISZ(4096) )
IDC0508I DATA ALLOCATION STATUS FOR VOLUME SER007 IS 0
IDC0509I INDEX ALLOCATION STATUS FOR VOLUME SER007 IS 0
IDC0512I NAME GENERATED-(D) SER07.VSAM.TS.DATA
IDC0512I NAME GENERATED-(I) SER07.VSAM.TS.INDEX
>----->c lib.test
PDS200I DISP UNIT OPT RECFM LRECL BLKSIZE ALLOCTRK FREETRK SECONDARY FREEDIR
PDS200I SHR 3380 C FB 80 9040 1X 47 10 40 TRK 24
MAP Subcommand
The MAP subcommand lists the CSECT structure of a load module. It can also modify the
addressing mode and residence mode of specific module CSECTS. The map it produces is
similar to the output produced by the MAP option of the linkage editor.
Example
MAP mema:memb
Syntax
MAP memgroup [FULL/SHORT/ENTRY/RELINK/JCL/LCT ]
[EXTERN/WKEXTERN/PSEUDOREG/LABELREG/COMMON/PRIVATE/CSECT]
[OFFSET(hexoff) ]
[NOSYSTEM ]
[MODULE({* / Fullm / Partm*)} ]
[REPLACE ]
[AMODE24/AMODE31/AMODE64 AMODEANY RMODE24/RMODEANY ]
[MEMBERS / MEMLIST / ML / NEWML / SUBLIST ]
Aliases
MA, MAPD
Defaults
memgroup, FULL
Required
none
Operands
memgroup Identifies the load members for which you want map information.
Default member names, member lists, member name ranges,
and member name patterns are allowed. For more information,
see Appendix A, "Formatting Member Names".
FULL Provides a full CSECT map. This option also provides the name of
the corresponding main module for alias members unless
CONTROL NOALIASINFO is in effect.
SHORT Provides a CSECT map with entry names within CSECTS, missing
weak external references, and alias member names omitted.
ENTRY Displays only the ENTRY point symbol.
RELINK Generates JCL and linkage editor control statements for use in
relinking this module.
JCL Generates JCL and linkage editor control statements for use in
relinking this module.
LCT Generates commented linkage attributes and linkage editor
control statements for use in managing this module.
OFFSET(hexoff) Specifies a 1- to 8-character hexadecimal offset for the origin of
this load module.
EXTERN Load modules with missing external symbols are wanted. The
MODULE keyword can also be specified to search for specific
symbols.
WKEXTERN Load modules with missing weak symbols are wanted. The
MODULE keyword can also be specified to search for specific
symbols.
PSEUDOREG Load modules with PSEUDO register symbols are wanted. The
MODULE keyword can also be specified to search for specific
symbols.
LABELREF Load modules with ENTRY symbols are wanted. The MODULE
keyword can also be specified to search for specific symbols.
COMMON Load modules with COMMON area symbols are wanted. The
MODULE keyword can also be specified to search for specific
symbols.
PRIVATE Load modules with PRIVATE area symbols are wanted. The
MODULE keyword can also be specified to search for specific
symbols.
CSECT Load modules with CSECT symbols are wanted. The MODULE
keyword can also be specified to search for specific symbols.
MODULE(nm) Specifies a 1- to 8-byte partial external name that limits CSECT
and ENTRY names for map reporting.
The MODULE operand has several valid forms:
MODULE(*) – uses the previous name entered on any MODULE
keyword
MODULE(Fullm) – reports only on CSECT or ENTRY name FULLM
MODULE(Partm*) – reports only on CSECT or ENTRY name
PARTM...
REPLACE Specifies with RELINK, LCT, or JCL to indicate all CSECTS are to
be listed with binder REPLACE statements before the binder
INCLUDE statement. REPLACE can also be used with the
MODULE keyword to select module names for replacement.
AMODE24 Sets the addressing mode of CSECTS identified by MODULE to 24.
AMODE31 Sets the addressing mode of CSECTS identified by MODULE to 31.
AMODE64 Sets the addressing mode of CSECTS identified by MODULE to 64.
RMODE24 Sets the residence mode of CSECTS identified by MODULE to 24.
RMODE64 Sets the addressing mode of CSECTS identified by MODULE to 64.
AMODEANY Sets the addressing mode of CSECTS identified by MODULE to
ANY.
RMODEANY Sets the addressing mode of CSECTS identified by MODULE to
ANY.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------------------------------------------------------------
--------------------------- ISPMODE Session Display ---------- ROW 115 OF 127
COMMAND ===> map zap$ SCROLL ===> CSR
- DSN=C911407.LINK.LOAD,VOL=SER=STR804 MEM=ZAP$ ----------------------------
** MAP ZAP$
ZAP 00000000 00003F06
PCL 00003F08 000000E5
CSOUT 00003FF0 00000428
ZAPHELP 00004418 00001B1C
ASMGASM 00005F38 000007E4
PDS103I Entry point at 00000000 -- ZAP
PDS104I Module length 00006720 -- 27K
PDS066I Member is an alias for: ZAPMAIN
** MAP DSAT
DSAT 00000000 00001CC8 RMODE 24 AMODE 64
DSATPDS 00001CC8 00000498 RMODE 24 AMODE 64
DSATPCL 00002160 000003F8 RMODE 24 AMODE 64
** MAP DSAT
DSATPDS 00001CC8 00000498 RMODE ANY AMODE 31
DSATPCL 00002160 000003F8 RMODE ANY AMODE 31
** MAP DSAT64
//LKED EXEC PGM=IEWL,
// PARM=’NCAL,MAP,LIST,LET,RENT,REUS,REFR’
//SYSUT1 DD UNIT=SYSDA,SPACE=(2048,(200,20))
//SYSPRINT DD SYSOUT=*
//SYSLIB DD DISP=SHR,DSN=WSER07.LINK.LOAD
//SYSLMOD DD DISP=SHR,DSN=WSER07.LINK.LOAD
//SYSLIN DD *
REPLACE DSAT,DSATPDS,DSATPCL
INCLUDE SYSLIB(DSAT64)
ORDER DSAT64,DSATPDS,DSATPCL
MODE RMODE(ANY),AMODE(64)
SETCODE AC(1)
ENTRY DSAT64
NAME DSAT64(R)
** MAP DSAT64
//LKED EXEC PGM=IEWL,
// PARM=’NCAL,MAP,LIST,LET,RENT,REUS,REFR’
//SYSUT1 DD UNIT=SYSDA,SPACE=(2048,(200,20))
//SYSPRINT DD SYSOUT=*
//SYSLIB DD DISP=SHR,DSN=WSER07.LINK.LOAD
//SYSLMOD DD DISP=SHR,DSN=WSER07.LINK.LOAD
//SYSLIN DD *
REPLACE DSATPDS,DSATPCL
INCLUDE SYSLIB(DSAT64)
ORDER DSAT64,DSATPDS,DSATPCL
MODE RMODE(ANY),AMODE(64)
SETCODE AC(1)
ENTRY DSAT64
NAME DSAT64(R)
MASK Function
The MASK command is an extension to the LISTC and LISTF commands. It allows you to
enter a data set mask or a volume mask and to then optionally execute the LISTC or
LISTF function.
Example
MASK ser07.lib.*
Syntax
MASK mask [n/VOLUME/VOLUME(vmask) ]
[CLEAR/NOCLEAR ]
[UPDATE/LC/LISTC/LF/LISTF]
[RESET ]
[NOFILTER ]
[PROMPT ]
Aliases
MAS, MASK
Defaults
1, CLEAR, LISTC
Required
mask
Operands
mask Identifies the mask that is to be applied to LISTC or LISTF.
For the LISTF volume mask, user a / for a pattern specification; use
an * for a combination name, and a : for a range. For example:
TSO/03, TSO*, and TSO:TSO80.
If the mask is for a data set name, each level can contain an * before
or after any characters in that level. For example: SYS1.NU*.*.*XY.
The first level can contain an * after a beginning character string.
n/VOLUME Identifies the position that this mask is to occupy (1 - 3 for a data set
mask) or VOLUME for a volume mask.
The VOLUME keyword can contain a volume mask. If you do this, the
first mask is considered a data set mask; otherwise, the first mask is
considered a volume mask.
CLEAR Clears out the other mask entries.
NOCLEAR Leaves the other mask entries.
UPDATE Updates the mask only.
LC Executes LISTC with this mask.
LISTC Executes LISTC with this mask.
LF Executes LISTF with this mask.
LISTF Executes LISTF with this mask.
RESET Clears the current LISTC/LISTF table before executing LISTC or LISTF.
NOFILTER Ignores all FILTER options and resets all of the FILTER options to their
defaults.
PROMPT Displays MASK prompt panel after updating with string.
Remarks
MASK provides a way to update LISTC/LISTF parameters without prompting. You can use
it from a WORKPAD to build and execute a complicated LISTF table. The following MASK
command builds a data set table from a catalog search of data sets using the single data
set mask, USERID.*.CNTL:
MASK USERID.*.CNTL
The following MASK command builds a data set table from a VTOC search of all PUBxxx
volumes using the single data set mask, USERID.*.CNTL:
The following MASK commands build up 3 data set masks. The first MASK command
clears all previous masks and the next one adds an additional data set mask. The last
MASK command adds a data set mask, a volume mask, and starts the VTOC search to
build the LISTF table.
The following MASK command continues a data set search to additional volumes starting
with SYS:
MEMBERS Subcommand
The MEMBERS subcommand lists members that are in the current member group. It is
often used to check member names in a given group before invoking another
subcommand that processes member groups.
Example
MEMBERS mema:memb
Syntax
MEMBERS memgroup [COUNT / NOCOUNT/ ONLYCOUNT NOBLDL]
Aliases
ME, MEM, MEMB, MEMBE, MEMBER, MEMBERS
Defaults
memgroup, COUNT
Required
none
Operands
memgroup Identifies the members whose names are to be displayed.
Default member names, member lists, member name ranges, and
member name patterns are allowed. For more information, see
Appendix A, "Formatting Member Names".
COUNT Issues a summary message to display the number of members in the
current group.
NOCOUNT Does not issue a summary count message.
ONLYCOUNT Issues only a message indicating the number of members in the
current group.
NOBLDL The existence of each member in the current group need not be
verified with a BLDL macro. This parameter is intended for high-
performance applications in conjunction with the SUBLIST
subcommand.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------------------------------------------------------------
--------------------------- ISPMODE Session Display ---------- ROW 150 OF 155
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.LINK.LOAD,VOL=SER=STR804 MEM=(ASID ---------------------------
>----->if : rmode31 then(sublist)
>----->members
PDS165I Members are: ASID, ASIDZN, JOB0LIST, MAPXA, PDSPGM, SORT, TSDYNLXA,
WHAT, WHATO, X$SPACE, XVOLS
MEMLIST Function
The MEMLIST subcommand builds a scrollable member list display on which StarTool FDM
subcommands can be entered as line commands to process individual members. Enter
ISPF commands, StarTool FDM subcommands, and primary commands to the right of
COMMAND==>. For additional information, see Appendix A, "Formatting Member
Names".
Example
MEMLIST mema:memb
Syntax
MEMLIST memgroup
[SINCE/BEFORE ]
[TODAY/YESTERDAY/WEEK/CURRENT/BIWEEK/
MONTH/QUARTER/HALFYEAR/YEAR/BIYEAR/
LAST(numdays)/DATE(yyyy/mm/dd) ]
[CHANGED(yyyy/mm/dd:yyyy/mm/dd) ]
[CREATED(yyyy/mm/dd:yyyy/mm/dd) ]
[ABOVE(Count1) ]
[ALIAS/NOALIAS ]
[AMODE24/AMODE31/AMODE64/AMODEANY/NOAMODE24/
NOAMODE31/NOAMODE64/NOAMODEANY ] (load only)
[AUTH/NOAUTH ] (load only)
[BELOW(Count2) ]
[DC/NODC ] (load only)
[EDIT/NOEDIT ] (load only)
[EXEC/NOEXEC ] (load only)
[FLEVEL/NOFLEVEL ] (load only)
[HASALIAS/NOHASALIAS ]
[ID(Puid)/NOID/NOTID(Puid) ]
[LKED(Partl) ] (load only)
[LOADONLY/NOLOADONLY ] (load only)
[MODULE(* / Fullm / Partm*) ] (load only)
[NULL/NONULL ]
[ORPHAN/NOORPHAN ]
[OVERLAY/NOOVERLAY ] (load only)
[PAGE/NOPAGE ] (load only)
[REFR/NOREFR ] (load only)
[RENT/NORENT ] (load only)
[REUS/NOREUS ] (load only)
[RMODE24/RMODEANY/NORMODE24/NORMODEANY] (load only)
[SCTR/NOSCTR ] (load only)
[SSI(hxdata)/SSI/NOSSI/PARTSSI(hxdata)]
[SYSMOD(Partu) / USERDATA(Partu) ] (load only)
[TEST/NOTEST ] (load only)
[TRANS(Partt) ] (load only)
[TTR(Lttr:Httr) ]
[USERDATA(Partu) / SYSMOD(Partu) ] (load only)
[USERID(Puid)/NOUSERID/NOTUSERID(Puid)]
[VSLKED/NOVSLKED ] (load only)
[ZAP(Partz) ] (load only)
[RESET/NORESET ]
[LKEDDATE/NOLKEDDATE ] (load only)
Aliases
ML, MEML, MEMLI, MEMLIS, MEMLIST
Defaults
memgroup, NORESET, LKEDDATE, SINCE
Required
none
Operands
memgroup Identifies the members that are to be added to the member
list.
Default member names, member lists, member name ranges,
and member name patterns are allowed. For more information,
see Appendix A, "Formatting Member Names".
SINCE Uses dates from the specified date to the current date. SINCE
indicates that the implied date range (TODAY, YESTERDAY, ...
LAST, DATE) follows the date given. For source modules, the
date referenced is the ISPF modification date; for load
modules, it is the linkage edit date.
FROM Uses dates from the specified date to the current date. FROM
indicates that the implied date range (TODAY, YESTERDAY, ...
LAST, DATE) follows the date given. For source modules, the
date referenced is the ISPF modification date; for load
modules, it is the linkage edit date.
BEFORE Uses dates before (and including) the specified date. BEFORE
indicates that the implied date range (TODAY, YESTERDAY, ...
LAST, DATE) is before the given date. For source modules, the
date referenced is the ISPF modification date; for load
modules, it is the linkage edit date.
TO Uses dates before (and including) the specified date. TO
indicates that the implied date range (TODAY, YESTERDAY, ...
LAST, DATE) is before the given date. For source modules, the
date referenced is the ISPF modification date; for load
modules, it is the linkage edit date.
TODAY A date, equivalent to LAST(0).
YESTERDAY A date, equivalent to LAST(1).
WEEK A date, equivalent to LAST(7).
CURRENT A date, equivalent to LAST(10).
BIWEEK A date, equivalent to LAST(14).
MONTH A date, equivalent to LAST(30).
QUARTER A date, equivalent to LAST(120).
HALFYEAR A date, equivalent to LAST(183).
YEAR A date, equivalent to LAST(365).
BIYEAR A date, equivalent to LAST(730).
LAST(numdays) A date indicating the number of days before today.
DATE(cdate) A date indicating the actual date; enter it in ISPF format (yyyy/
mm/dd), or Julian format (yyyy.ddd).
CHANGED(date: Searches for members modified by an ISPF editor or a ZAP
program between the dates specified. If you enter only a single
date, only that date is checked, but normally a date range like
CHANGED(yyyy/mm/dd:yyyy/mm/dd) is entered.
Only members with ISPF statistics or members created by a
linkage editor are supported.
Remarks
MEMLIST line commands and their outputs are maintained in the log.
If a StarTool FDM subcommand is too long for the 48-character input field, enter the first
47 or less characters followed by a + to indicate more data is required. A continuation
panel with more room for operand entry displays.
The primary screen for MEMLIST generally shows the most commonly used member
attribute information and the alternate screens show some additional data. For source
members, the secondary screen adds member TTR information and an ALIASOF field that
is filled in for alias members as a result of entering ALIASCHK (alias check or option 55).
The primary screen fields are:
The second source member screen reformats the data and adds the following data for
each member:
ALIASOF Alias information field. For aliases, this field contains *ALIAS until a
ALIASCHK (option 55) is performed. After that point, it contains the name
of the corresponding main member if it exists or *ORPHAN otherwise.
TTR TTR address. The address of the first record for this member relative to
the start of the data set.
Load members have four different screens defined. The first screen contains the linkage
edit date and most information required to manipulate load members. The second screen
adds more detailed information; the third screen combines the first two screens and the
fourth screen can be customized and contains Change Man data.
TTR TTR address. The address of the first record for this member
relative to the start of the data set.
MATCH Matching member by TTR. This field is for alias entries. It is
filled in by ALIASCHK (option 55) to show the name of the
matching main member according to the TTR address. If the
ALIASOF field has an unusual value (such as =BYTTR or
=BYNAME), this field and the MAIN field provide names of the
affected members.
LENGTH Module length. Hexadecimal length of the module.
LEN-KB Module length in 1024 or K-byte units.
ENTRY Entry point address in hexadecimal.
SSI SSI data in hexadecimal.
Save MEMLIST tables permanently. They are saved in the ISPF profile data set by default
(ISPPROF) but you can change the DDNAME in the SETALL option. To manage these
tables, use the SAVE and MERGE commands.
Saved MEMLIST tables are given members names of the form PDSML0na if the name is
one or two numeric digits; otherwise, a name of the form @#name is used where name is
a 1- to 6-character alphanumeric table identification name.
The following primary commands are supported directly for the MEMLIST function. For
information on ISPMODE commands available in StarTool FDM, see “Common Commands”
in Chapter 2, "ISPF Interface Commands".
ALIASCHK Alias check. Checks aliases and adds all associated members to the
MEMLIST display.
ALL MEMLIST all. Adds all members in the data set to the MEMLIST
display.
ALT[ERNAT] Displays an alternate view of the MEMLIST table.
APP[LY] Applies the specified line command to all table entries and executes
each entry.
BAT[CHJCL] Builds batch JCL that includes all StarTool FDM statements in the LOG
table.
DUA[L] Displays a double line view of the MEMLIST table.
EDITT[BL] Enters an edit session on MEMLIST table data.
(or ET[BL])
EQ[UATE] SUBLIST =. Resets the current member group to the members in the
current MEMLIST.
EXPR[ESS] Executes all entered line commands without pauses between
individual commands.
F Finds a string and positions the display start location.
Syntax F anystring [ASIS]
[FIRST/LAST/PREV] [PREFIX/SUFFIX/WORD]
[ANY/MEMBER/DATE/LENGTH/ENTRY/MAIN/
/MATCH/SSI/TTR/ALIASOF] (for load)
[ANY/MEMBER/VERMOD/CREATED/MODIFIED/
/SIZE/INIT/ID/TTR/ALIASOF] (for source)
LE[FT] Rotates through alternate views of the MEMLIST table. PF keys 10
and 22 are normally set to LEFT.
L[OCATE] Positions to a data line in sorted tables by searching the current
sorted column for the specified data.
Syntax LOCATE pmember/ttr/puserid/pdate/size/vermod
/plinkdate/hexlength/apf/attrib/pssi
MER[GE] Adds members to the MEMLIST table from a saved MEMLIST table.
Syntax MERGE name [RESET] [NOSTATS]
RF[IND] Finds a string (repeat find) and positions the display start location. PF
keys 5 and 17 are normally set to RFIND.
RI[GHT] Rotates through alternate views of the MEMLIST table. PF keys 11
and 23 are normally set to RIGHT.
SAVE Creates a permanent table for use in a different StarTool FDM session.
Syntax SAVE [name] [REPLACE/NOREPL]
SO[RT] Sorts function tables into an alternate order. SORT with no operands
sorts the table in default order, while SORT with a field name sorts the
table in that order.
Syntax
SORT
[MEMBER/TTR/DATE/SIZE/APF/MODE/ATTR/TTR] (load)
[MEMBER/TTR/VERMOD/CREATED/MODIF/SIZE/ID](source)
[ASCEND/DESCEND]
TAG Forms a member group containing only members marked with *TAG*
in the DATA/MSG field.
TOD[AY] Merges members updated or created today into the MEMLIST.
UT Selects the extended user command panel. Commands are
maintained in these panels by the StarTool FDM developers as well as
your installation. The MEMLIST UT panel also allows dynamic primary
commands with which you specify command names and their
corresponding actions.
WE[EK] Merges members updated or created this week into the MEMLIST.
X Clears the MEMLIST table relative to the cursor position.
Syntax X [ABOVE/BELOW/ALL]
In addition to the above, you can enter StarTool FDM subcommands and ISPF commands
on the command line. Also, if you want a StarTool FDM subcommand to apply to all
members currently in the MEMLIST, use = as the member group name for the
subcommand.
By default, line commands that produce output display it in an edit session and this
output is also recorded in the log. To place this output only in the log, check the setting of
“Automatic EDITLOG” in SETALL for MEMLIST. The following line commands are supported
in the MEMLIST function:
In addition to the above line commands, most StarTool FDM subcommands that define a
memgroup can be used as line commands. This set of subcommands includes ABE,
ACFCOMP, BROWSE, COPY, DCF, DELETE, DELINK, DIRENTRY, DISASM, DUP, EDIT, FIND,
FSE, HISTORY, LIST, LLA, MAP, OUTCOPY, PGMDOC, PRINT, READOBJ, REPLACE, REPRO,
REVIEW, SEPARATE, SUBMIT, TSOEDIT, TSOLIST, VERIFY, VPRINT, and XREF.
Also, you can use the ALIAS, COMPARE, REPRO, and RENAME subcommands as line
commands but they each require another member name to be entered as an operand in
the DATA/MSG field.
Each subcommand name must be abbreviated to a maximum of four characters to fit into
the CMD field. Also, several of the above subcommands are available only on source data
sets (ABE, ACFCOMP, DCF, EDIT, FSE, READOBJ, SUBMIT, and TSOEDIT) and others are
available only on load data sets (DELINK, DISASM, HISTORY, LLA, MAP, PGMDOC, and
XREF).
A restricted subset of line commands are available for examining and manipulating
deleted members. The following line commands are supported for this purpose:
E Edit. Enters edit on the deleted member. The SAVE command is not
permitted.
F Find. Searches the deleted member.
HIST History. Displays historical data from the deleted member (for load only).
K Kill. Cancels and clears all following line commands.
L List. Lists the deleted member.
LOG Log. Copies the line into the log.
M Menu. Provides line command selection and entry assistance.
MAP Map. Displays the structure of the deleted member (for load only).
LLA Informs LLA that the member has been deleted.
PB PBROWSE. Browses the deleted member.
PE PEDIT. Enters edit on the deleted member. The SAVE command is not
permitted.
REST Restore. Resurrects this deleted member.
REV Review. Browses the deleted member.
X X. Drops this deleted member from the MEMLIST table.
Block line commands are doubled letters that delimit a range of table entries for which the
same action is to be performed. The following block line commands are supported in the
MEMLIST function:
== = command. Repeats the previous line command for the range of lines.
*cm ERR- t=”Block line command,==”>
NUCMAP Function
The NUCMAP command displays the current system nucleus.
Example
NUCMAP
Syntax
NUCMAP
Aliases
NUC, NUCM, NUCMA, NUCMAP
Defaults
none
Required
none
Operands
none
Remarks
NUCMAP provides a way to look at the current nucleus by memory address. The CSECTS
table is used.
The CSECTS ISPF table displays in response to a NUCMAP command. When you are in a
CSECTS/NUCMAP display, you can delete a part of the table, sort the table in different
directions, find data in the table, print a part of the table or store a part of the table in a
data set. For assistance with the different options available, use the HELP command, CUA
functions or enter an O command as either a primary command or as a line command.
The CSECTS/NUCMAP table displays the names of all CSECTs and ENTRYs for the
NUCLEUS. The screen fields for each line are:
The following primary commands are supported directly for the CSECTS/NUCMAP
function. For information on ISPMODE commands available in StarTool FDM, see
“Common Commands” in Chapter 2, "ISPF Interface Commands".
APP[LY] Applies the specified line command to all table entries and executes
each entry.
Syntax APPLY linecmd
RF[IND] Finds a string (repeat find) and positions the display start location. PF
keys 5 and 17 are normally set to RFIND.
SO[RT] Sorts function tables into an alternate order. SORT with no operands
sorts the table in default order, while SORT with a field name sorts
the table in that order.
Syntax SORT [ADDRESS/NAME]
[ASCEND/DESCEND]
TAG Applies the specified line command to table entries marked with
*TAG* in the DATA/MSG field and executes each entry.
Syntax TAG linecmd
Block line commands are doubled letters that delimit a range of table entries for which the
same action is to be performed. The following block line commands are supported in the
CSECTS function:
== = command. Repeats the previous line command for the range of lines.
*cm ERR- t=”Block line command,==”>
OPTIONS Subcommand
The OPTIONS subcommand displays the subcommands (or options) supported by StarTool
FDM. This display varies when a non-partitioned data set is being processed.
In any table function, if the O alias of OPTIONS is entered as a line command, the
O Subcommand Selection panel displays to assist in entering subcommands. In
ISPMODE or MEMLIST, the O alias of OPTIONS at the COMMAND ==> prompt also brings
up the subcommand assist prompt panel.
Example
OPTIONS
Syntax
OPTIONS
Aliases
O, OP, OPT, OPTI, OPTIO, OPTION, OPTIONS
Operands
No operands are supported for the OPTIONS subcommand.
OUTCOPY Subcommand
The OUTCOPY subcommand formats utility control statements that can be used by
IEBCOPY to select members from a data set. Output is directed to a pre-allocated FILE
with the DDNAME PDSOUT.
Example
OUTCOPY mema:memb
Syntax
OUTCOPY memgroup [ALIAS/NOALIAS ]
[CLOSE/NOCLOSE ]
[ECHO/NOECHO ]
[IEBUPDTE/NOIEBUPDTE ]
[REPLACE ]
[TEXT('string')/NOTEXT]
Aliases
OUTC, OUTCO, OUTCOP, OUTCOPY
Defaults
initially: memgroup, ECHO, NOCLOSE, NOALIAS, NOTEXT, NOIEBUPDTE
Required
none
Operands
memgroup Identifies the member names to be output on an IEBCOPY format
select statement.
Default member names, member lists, member name ranges, and
member name patterns are allowed. For more information, see
Appendix A, "Formatting Member Names" on page 417.
ALIAS Includes any associated member names (aliases, apparent aliases,
and associated main members) in the members processed.
NOALIAS Processes only members actually identified.
CLOSE Closes the PDSOUT file. The member or member group specified
with the CLOSE operand is not output to the PDSOUT file.
NOCLOSE Opens or keeps the PDSOUT data set open.
ECHO Echoes each utility control statement to the terminal as well as to
the PDSOUT data set.
NOECHO Does not echo the utility control statements to the terminal; output
is only directed to the PDSOUT data set.
IEBUPDTE Formats each output statement in IEBUPDTE format instead of the
standard IEBCOPY format. The use of this format also suppresses
COPY statements normally generated for data set changes.
NOIEBUPDTE Formats each output statement in the standard IEBCOPY format.
REPLACE Specifies that the form of the COPY statement is to be changed to
support replacing members in the target data set.
TEXT('st') Replaces the second member name on each subsequent SELECT
output statement with the specified string, ST.
NOTEXT Nullifies any TEXT operand and writes the second copy of the
member name (as usual) on each subsequent SELECT output
statement.
Remarks
OUTCOPY does not use ISPF services. If StarTool FDM was invoked from READY mode,
StarTool FDM attempts to establish an ISPF environment for the first OUTCOPY
subcommand so that subsequent subcommands can use ISPF services.
3 For new data sets, the following default DCB attributes are used:
DCB=(RECFM=FB,LRECL=80,BLKSIZE=3120)
4 An IEBCOPY COPY statement is written before the first SELECT statement for each
data set as determined by the CHANGE subcommand. The COPY statement is of the
form:
COPY OUTDD=OUTPUT,INDD=xxx
(where xxx is the low-level qualifier of the input data set name)
However, if the REPLACE keyword is in effect, the format is:
COPY OUTDD=OUTPUT,INDD=((xxx,R))
S M=memname,memname))
memname is the member name. You can modify this format output statement by an
editor if member rename or member replace functions are to be performed. If you
specify TEXT('Any String'), each subsequent IEBCOPY statement changes to the form:
6 OUTCOPY maintains a list of member names written after each copy statement and
does not output a member name more than once.
7 You can establish a CLIST such as the following for IEBCOPY use:
Another method for capturing IEBCOPY control statements is to use the COPY
subcommand with the NOCALL keyword. Obtain the generated images using the CONTROL
subcommand with the DSN keyword or by the ISPMODE OUTPUT command.
PATTERN Subcommand
The PATTERN subcommand lists member names from the data set directory. Only those
member names that contain the PATTERN name segments specified display. The default
member group is not affected by the DISPLAY or PATTERN subcommands.
You can enter one or two member name segments as patterns. If you enter two
segments, both segments must occur in a member name for it can be displayed. For
example, with the pattern segments xx and 1x, members named M1X4XX, M1XX, and
XX1X are displayed by this subcommand while members named X1X or MXX13X are not
displayed.
Example
PATTERN iea/sys
Syntax
PATTERN [segment1 [segment2] ]
Aliases
P, PA, PAT, PATT, PATTE, PATTER, PATTERN
Defaults
previously entered segment1 and segment2 operands
Required
none
Operands
segment1 A name segment that must be found in a member name for the member
name to be displayed.
Enter a group name descriptor such as part1:part2, seg1/seg2, or
part1*seg1 for segment1, in which case, the output consists of the
member names that are displayed by the MEMBERS subcommand.
segment2 A second name segment that must also be found in a member name for
the member name to be displayed.
Remarks
Neither PATTERN nor DISPLAY affect the current member group. If you enter PATTERN
without operands, the previously entered operands are used. This differs from DISPLAY. A
DISPLAY with no operands shows all members in the data set.
-A is added following a displayed member name if the member name is an alias. The
member name is listed in a combined hexadecimal/character format if it does not contain
upper case alphanumeric characters (including @, $, and #) or if the first character is
numeric. Unprintable characters (for 3270-type devices) in a member name display as
periods.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------------------------------------------------------------
--------------------------- ISPMODE Session Display ---------- ROW 273 OF 285
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.LIB.TEST,VOL=SER=STR815 MEM=(ASID ----------------------------
>----->d
@DIACLIK @DIAINIT @DIALOG @DIAPANL @DIAPART @DIASTAK
@DIATBL @DIAWRK ALLGLOB ASMEXT2 CHECKOUT CICS
COMPARE COMPARES COMPA1 COMPA2 COMPA3 DISAMSM
DISAMXM DISASME DISASMX DISASM3 MAPXREF PDS99
PDS99T1D TESTMSG
>----->p dia
@DIACLIK @DIAINIT @DIALOG @DIAPANL @DIAPART @DIASTAK
@DIATBL @DIAWRK
>----->p al/
@DIALOG ALLGLOB
>----->p ob/al
ALLGLOB
>----->p dis*
DISAMSM DISAMXM DISASME DISASMX DISASM3
>----->p
DISAMSM DISAMXM DISASME DISASMX DISASM3
PBROWSE Function
PBROWSE (for parallel browse) is a multiple-format data set browser that supports most
z/OS data access methods and database management systems. PBROWSE is called a
parallel function because you can suspend a browse session to process other data sets
using GO sessions. On returning control to the browse session, resume where you left off
as with other StarTool FDM parallel activities.
Invoke PBROWSE directly under control of StarTool FDM with the PBROWSE command, or,
using the SUPEREDIT option, invoke it transparently with the BROWSE command. Use PB
(for PBROWSE) as a line command in MEMLIST.
PBROWSE supports sequential, direct, PDS, PDSE and all VSAM data types including
PATHs. It also allows you to browse deleted members. In addition, you can perform VSAM
positioning.
NOTE PBROWSE does not support multivolume files. It also cannot be used with
variable-length (VB or VS) file organizations. For these file types, use PVIEW or PEDIT
instead of PBROWSE.
Example
PBROWSE
Syntax
PBROWSE member
* [FROMKEY(key)/FROMADDRESS(add)/FROMNUMBER(num) ]
* [TOKEY(key)/TOADDRESS(add)/TONUMBER(num) ]
*NOTE: Lines with an asterisk are supported for VSAM data sets only
Aliases
PB, PBR, PBRO, PBROW, PBROWS, PBROWSE
Abbreviations
FKEY for FROMKEY, FADDR for FROMADDRESS, FNUM for FROMNUMBER, TKEY for TOKEY,
TADDR for TOADDRESS, and TNUM for TONUMBER.
Defaults
none
Required
member
Operands
member Identifies the member to be browsed.
FROMKEY(ky) For VSAM data sets only, ky is coded as the key of the
first record to be accessed. This is a generic key and can
be coded as x’hexkey’; access begins at the first record
whose key matches (or is greater than) the portion of the
key specified. Use this parameter with TOKEY. Specified
for an alternate index or a key-sequenced data set only.
Remarks
Use a LOG command to suspend PBROWSE. Then move to other StarTool FDM processes;
however, use any function name or subcommand that does not conflict with the command
names supported for PBROWSE.
The following primary commands are supported directly in the PBROWSE function. For
information on ISPMODE commands available in StarTool FDM, see "Common Commands"
on page 39.
Displays a columns line on the first line of the data area. The columns
line remains at the top of the data display. It is useful in identifying
CO[LS] columns to be used with the FIND command.
Syntax COLS [ON/OFF]
PAD Changes the padding character and specifies the number of pad
characters desired.
Syntax PAD character/'character'/x'hex' [column]
Example: PAD a 45
RF[IND] Finds a string (repeat find) and positions the display start location. PF
keys 5 and 17 are normally set to RFIND.
PEDIT Function
PEDIT (for parallel edit) is a multiple-format line editor that supports most z/OS data
access methods and database management systems. PEDIT is called a parallel function
because you can suspend an edit session to process other data sets using GO sessions.
On returning control to the edit session, resume where you left off as with other StarTool
FDM parallel activities.
PEDIT supports sequential data sets, striped sequential data sets, direct files, VSAM keyed
sequential data sets (including either a base cluster or a path over a cluster), other VSAM
data set types, partitioned data sets (PDSs), and extended partitioned data sets (PDSEs).
Invoke PEDIT directly under control of StarTool FDM with the PEDIT command, or, using
the SUPEREDIT option, invoke it transparently with the EDIT command.
Example
PEDIT
Syntax
PEDIT [member|memgroup]
[AUDIT]
[BACKUP]
[COPYBOOK]
[LOAD|NOLOAD|BLOCK]
[SELECT]
[VIEW]
* [FROMKEY(key)|FROMADDRESS(address)|FROMNUMBER(record_number)]
* [TOKEY(key)|TOADDRESS(address)|TONUMBER(record_number)]
*NOTE: Parameters marked with an asterisk are supported for VSAM data sets only.
Aliases
PE, PED, PEDI, PEDIT
Defaults
LOAD (NOLOAD for non-KSDS VSAM data sets)
Required
None
Operands
member Name of data set member to be edited. If no default data
set name has been set, PEDIT will prompt for data set. If
no member or memgroup is supplied, PEDIT will prompt
for member name and data set.
Alternative: memgroup
memgroup Memlist or memgroup naming multiple data set members
to be edited in sequence during this PEDIT session. If no
default data set name has been set, PEDIT will prompt for
data set. If no memgroup or member name is supplied,
PEDIT will prompt for member name and data set.
Alternative: member
LOAD The entire member is to be loaded into memory for editing
and rewritten completely at the SAVE command. With this
option, record lengths can be modified (even for VSAM
ESDS data sets) and line commands such as I (insert),
C (copy), D (delete), M (move), and R (repeat) are
available.
Restrictions: VSAM data sets must be marked REUS or
must be empty. Executable load members may not use
the LOAD option.
Synonym: REUSE
Alternatives: NOLOAD, BLOCK
NOLOAD Only changed records are kept in memory. Line commands
that modify data records are not available.
BLOCK Only changed records are kept in memory and the edit
display consists of one line for each physical record. Line
commands that modify data records are not available.
Remarks
PEDIT supports records lengths to 32K with updates made directly to a VSAM data set.
Use a LOG command to suspend PEDIT and then go to other StarTool FDM processes.
Enter any StarTool FDM function name to suspend PEDIT, but do not suspend it with a
StarTool FDM subcommand. For example, enter LISTC to suspend PEDIT and go to the
LISTC/LISTF function; however, if you enter REPLACE, an invalid command prompt is
returned.
PEDIT is similar to ISPF edit. You can also perform VSAM positioning. Usually changes in a
VSAM KSDS are made by typing over individual characters; these characters are not
upper-case (however, the CAPS command is supported).
If records are moved or copied out of sequence, PEDIT marks the record with ==SEQ> in
the line number column. In a similar fashion, duplicate records are marked with ==DUP>
in the line number field.
The keys for these records (and for records that are moved but remain in key sequence)
are unprotected so that you can change the key field. PEDIT does not permit you to save
a data set if records are out of order or if there are duplicate keys; however, you can
CANCEL the session.
Record exclusions with the X line command or the EXCLUDE or X primary command are
not yet supported.
For sequential data sets, LOAD is the default; however, for very large data sets you can
use NOLOAD. Only changed records are retained in memory. Also, only changed data
blocks are rewritten for a SAVE command.
PEDIT supports editing a PDS load member and NOLOAD is forced. If a load member is
updated with PEDIT, it marks the user’s USERID as the ZAP IDR data and it assumes that
the first CSECT of the module was modified (PEDIT is not aware of CSECT boundaries).
Editing a PDS load member is equivalent to zapping the member; however, it is much
simpler to perform with an edit.
For a PDS source member, LOAD is the default; however, you can specify NOLOAD or
BLOCK.
For a PDSE source member, LOAD is forced; an updated member is always entirely
rewritten when it is saved. PEDIT does not currently support saving PDSE program
objects.
For VSAM data sets other than KSDS data sets, NOLOAD is forced; line commands that
modify the data set are not supported and only modified records are rewritten to the data
set. For a variable RRDS, you can modify the lengths of individual records in a PEDIT
session.
1 Enter a CB command.
3 This displays all members matching the generic member name in a MEMLIST.
4 Examine the members with E (edit), B (browse), or CBM (CBMAP) line commands.
5 Enter S (select) to select the desired copybook member and pass its name to
copybook prompt.
6 Press Enter to process the data set with the selected copybook member.
Use a copybook in normal copybook mode (displayed in layout mode with one record on a
screen), extended copybook mode (using multiple copybook members selected by data
values), or vertical copybook mode (multi-record displayed in tabular mode using headers
from the copybook).
Extended copybook support provides for copybooks with base and segment portions. The
appropriate copybook is selected dynamically based on record values. Save and manage
these copybook selections with the PROFMAN application. Once PEDIT is active, you can
use the PROFMAN application to position to the CB portions and type an S line command
to activate an extended copybook table.
To use extended copybooks, select copybook support from PEDIT or PVIEW and specify
TEMP, REDO, CREATE, or MOD on the extended copybook line near the bottom. To modify
an existing extended copybook member, type its name in the copybook save name field.
Use the TEMP option to enter a temporary extended copybook table that will not be saved
and use REDO to modify a temporary extended copybook table. Use CREATE to create a
saved extended copybook table and MOD to modify an existing table.
If you have multiple 01 levels in different copybooks, you normally define each one as a
BASE. If a file definition is split into two or more copybooks, define the first part as a
BASE from one copybook member and multiple following parts from different copybooks
as SEGMENT sections. There must always be at least one BASE segment. Each one can be
associated with multiple SEGMENT sections.
Once you are in the extended copybook dialog, type an S line command to define the first
base segment and fill in the desired elements on the copybook selection panel. Be sure to
enter the type (BAS for BASE or SEG for SEGMENT) for each item.
Type an A primary command when you want to activate the extended copybook in PEDIT.
This restarts the edit session.
The following primary commands are supported directly for the PEDIT function. For
information on ISPMODE commands available in StarTool FDM, see "Common Commands"
on page 39.
BOU[NDS] Specifies default find column limits. BOUNDS OFF and BOUNDS
with no operand turn-off-bounds processing. BOUNDS LIST shows
current boundaries.
F[IND] Finds a string and positions the display start location. Search
strings up to 64 characters in length are supported.
Syntax
FIND anystring [nn mm] [ASIS] [ALL]
[FIRST|LAST|PREV] [PREFIX|SUFFIX|WORD]
[CHECK] -- for copybook, searches for invalid packed decimal
[NAME] -- for copybook, positions to a copybook variable name
[SAME] -- for copybook, searches only the current record
KEY Positions directly to the record with the corresponding record key.
Syntax KEY 'record key' | x'hexkey'
OUT[PUT] Outputs the current PEDIT edit record to print or a data set using
the current display mode (character, hexadecimal, or copybook).
Syntax OUTPUT [=c | F(ddname)]
PAD Changes the padding character and specifies the number of pad
characters desired.
Syntax PAD character|'character'|x'hex' [column]
Example: PAD a 45
PASTE Places lines from the StarTool FDM clipboard into the active edit
session. Use the PEDIT or ISPF edit CUT macro to place lines into
the clipboard.
Syntax
PASTE [mm] [ZERO|KEEP] [DEFAULTS]
mm -- two character table name
ZERO -- insert clipboard contents and clear clipboard
KEEP -- insert clipboard contents and keep clipboard
DEFAULTS -- display a panel to set defaults
RCH[ANGE] Changes a string (repeat change) and positions the display start
location. PF keys 6 and 18 are normally set to RCHANGE.
RF[IND] Finds a string (repeat find) and positions the display start location.
PF keys 5 and 17 are normally set to RFIND.
REPL[ACE] Replaces a data set or member from marked copy or moves data
records in an edit session.
Syntax REPLACE [member]
SORT For a VSAM KSDS data set, sorts records into ascending order by
key.
Syntax SORT
This table contains the copybook screen part, the header, and an example:
COBOL level and name LEVEL AND NAME 02 SAMPLE-FIRST
data type=TYPE LENGTH TYPE 1 PAC
data type=PICTURE PICTURE S99V9
data type=OFFSET OFFSET 62
data type=COLUMN COLUMN 63
data type=NUMBER NUMBER 4
displayed data=DATA DATA
2.1
displayed data=NODATA OFFSET 62
displayed data=HEX DATA
F24BF1
Block line commands are doubled letters that delimit a range of table entries for which the
same action is to be performed. The following block line commands are supported in the
PEDIT function:
== = command. Repeats the previous line command for the range of lines.
*cm ERR- t=”Block line command,==”>
Primary command: MAP to view the copybook member before exiting this panel.
IMPORT or EXPORT to retrieve or save a copybook object.
Optional:
Language type ===> EITHER (COBOL, PLI, EITHER, or ASM)
Starting name ===>
Starting column ===> 1 (1 to 32760 if first variable is offset)
Primary command: MAP to view the copybook member before exiting this panel.
More: +
Specify the copybook data set and member in normal TSO syntax:
Data set ===> LIB.CNTL
Member name ===> cb001 (member if not included in dsname)
Data set type ===> MVS (MVS, Panvalet or Librarian)
Language type ===> EITHER (COBOL, PLI or EITHER)
Starting name ===>
Type ===> BASE (The first one must be a BASE)
Column number ===> 1 (1-32760 or Blank for default)
Compare operator/Length ===> EQ (LT,LE,EQ,GE,GT,NE or 0-32760)
Compare Strings ===> c'a' (string,string)
AND/OR ==> OR
Column number ===> (1-32760 or Blank for no compare)
Compare operator/Length ===> EQ (LT,LE,EQ,GE,GT,NE or 0-32760)
Compare Strings ===> (string,string)
Primary commands: S to Save this list, A to Activate this list, END to cancel.
Line commands: S to Select one line at a time and update selection options.
More: +
PVIEW Function
The PVIEW command is shorthand for PEDIT with the VIEW keyword. PVIEW can view a
data set even if it is currently being edited. PVIEW is equivalent to PEDIT with the SAVE
command disabled.
Example
PVIEW
Syntax
PVIEW member [REUSE/NOLOAD/BLOCK ]
[COPYBOOK/CB ]
[SELECT ]
[AUDIT ]
* [FROMKEY(key)/FROMADDRESS(add)/FROMNUMBER(num) ]
* [TOKEY(key)/TOADDRESS(add)/TONUMBER(num) ]
*NOTE: Lines with an asterisk are supported for VSAM data sets only
Aliases
PV, PVI, PVIE, PVIEW
Abbreviations
FKEY for FROMKEY, and FADDR for FROMADDRESS, TKEY for TOKEY, and TADDR for
TOADDRESS.
Defaults
none
Required
none
Operands
See the documentation for the “PEDIT Function”.
PGMDOC Subcommand
The PGMDOC subcommand lists module descriptions from a program table. The output is
a one-line description of each module in the member group.
Example
PGMDOC idc*
Syntax
PGMDOC memgroup
Aliases
PG, PGM, PGMD, PGMDO, PGMDOC
Defaults
memgroup
Required
none
Operands
memgroup Identifies the member names of interest.
Default member names, member lists, member name ranges, and
member name patterns are allowed; for more information, see
Appendix A, "Formatting Member Names" on page 417.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------------------------------------------------------------
--------------------------- ISPMODE Session Display ------------- ROW 1 OF 59
COMMAND ===> SCROLL ===> CSR
- DSN=SYS2.TSO.CMDLIB,VOL=SER=SYS804 MEM=(JBB2217 --------------------------
>----->pgm (jbb2217,dsnttttt,xyz456,isr*)
PDS235I PRODUCT FROM DESCRIPTION
JBB2217 MVSFMID IBM MVS/SP R2.1.7 5752***** R217
DSNTTTTT MVS IBM DB2 Prefix
XYZ456 UNKNOWN (THIS MODULE NAME WAS NOT FOUND)
ISRFR77 ISPF/PDF IBM 3277 French Translate Table
ISRFR77A ISPF/PDF IBM 3277 French APL Translate Table
ISRFR78 ISPF/PDF IBM 3278 French Translate Table
ISRFR78A ISPF/PDF IBM 3278 French Text Translate Table
ISRFR78T ISPF/PDF IBM 3278 French APL Translate Table
ISRGE78 ISPF/PDF IBM 3278 German Translate Table
ISRGE78A ISPF/PDF IBM 3278 German APL Translate Table
ISRHA78H ISPF/PDF IBM 5550 Korean Translate Table
ISRKA78K ISPF/PDF IBM 5550 Japanese Translate Table
ISRLALIN ISPF/PDF IBM LMF - All Listing Interface
ISRLAUCL ISPF/PDF IBM LMF - Activity Log Cleanup
ISRLCFCL ISPF/PDF IBM LMF - Control File Control
PRINT Subcommand
The PRINT subcommand prints a hardcopy list of a member. Use the TSO PRINTDS or
PRINTOFF command (as generated during StarTool FDM installation). Add any PRINTDS/
PRINTOFF operands after the member name.
Example
PRINT mema:memb form(0012) asa
Syntax
PRINT memgroup [ASA ]
[ASIS/CAPS ]
[CLASS(c) ]
[COPIES(num) ]
[DEST(destname) ]
[FCB(fcbname) ]
[FORMS(formname) ]
[HEADING/NOHEADING]
[HOLD/NOHOLD ]
[LIST/NOLIST ]
[NOMSG ]
[PRINT/NOPRINT ]
[PROG(progname) ]
[SNUM ]
[TEXT ]
[UCS(ucsname) ]
[VOLUME(volname) ]
Aliases
PR, PRI, PRIN, PRINT
Defaults
memgroup, CLASS(A), NOHOLD, LIST, PRINT, ASIS, HEADING
Required
none
Operands
memgroup Identifies the members to be printed.
Default member names, member lists, member name ranges, and
member name patterns are allowed; for more information, see
Appendix A, "Formatting Member Names" on page 417.
If the memgroup is specified as a : (for all members), the PRINT
command is called only once to print the entire data set.
others Optional. May include any desired TSO PRINTOFF or PRINTDS
operands.
Remarks
Either the TSO PRINTDS or PRINTOFF command is used. This choice was made during
StarTool FDM installation. To determine which program is used, enter a CONTROL
DEFAULT subcommand and look for an output line beginning ”PRINT calls”. This interface
is optional and should only be used with the TSO PRINTDS command or the public domain
PRINTOFF command.
PROFMAN Function
The PROFMAN (profile manager) command manages saved MEMLIST, LISTC/LISTF and
WORKPAD tables. Primary commands such as SORT, F (find), REMOVE, and OUTPUT are
useful in managing saved tables.
Syntax
PROFMAN
Aliases
PRO, PROF, PROFM, PROFMA, PROFMAN
Defaults
none
Required
none
Operands
none
Remarks
PROFMAN builds and displays a table containing all of your saved MEMLIST, LISTC/LISTF
and WORKPAD tables. From this display, you can inspect, manage, and activate any of
these tables.
The alternate (reached with a LEFT or RIGHT command) view of this function shows the
first line of each saved table. This should give you some context to help you identify a
given table.
The following primary commands are supported directly for the PROFMAN function. For
documentation on ISPMODE commands available anywhere in StarTool FDM, see
"Common Commands" on page 39.
RF[IND] Finds a string (repeat find) and positions the display start location.
PF keys 5 and 17 are normally set to RFIND.
RI[GHT] Rotates through alternate views of the PROFMAN table. PF keys 11
and 23 are normally set to RIGHT.
SO[RT] Sorts function tables into an alternate order. SORT with no operands
sorts the table in default order, while SORT with a field name sorts
the table in that order.
Syntax SORT [FUNC/NAME/MODIFIED/ID/SIZE]
[ASCEND/DESCEND]
QUIT Subcommand
The QUIT subcommand terminates StarTool FDM.
Example
QUIT
Syntax
QUIT
Aliases
Q, QU, QUI, QUIT
Operands
No operands are supported for the QUIT subcommand.
Remarks
The QUIT subcommand is equivalent to multiple END subcommands. Use it from
ISPMODE or MEMLIST instead of using repeated ENDs when you want to terminate
StarTool FDM and not just the current function.
READOBJ Subcommand
The READOBJ subcommand reads and disassembles object code.
Example
READOBJ PTF1107
Syntax
READOBJ memgroup [FLOAT/NOFLOAT ]
[MVS370/MVSXA/ESA370 ]
[PRIV/NOPRIV ]
[REASM ]
Aliases
READ, READO, READOB, READOBJ
Defaults
memgroup, NOFLOAT, NOPRIV, ESA370
Required
none
Operands
memgroup Identifies the members to be disassembled.
Default member names, member lists, member name ranges, and
member name patterns are allowed. For more information, see
Appendix A, "Formatting Member Names" on page 417.
FLOAT Includes floating-point instructions in the instruction set.
NOFLOAT Does not decode floating-point instructions.
MVS370 Uses only instructions defined on MVS/370 systems.
MVSXA Uses only instructions defined on MVS/XA systems.
ESA370 Uses only instructions defined on MVS/ESA systems. This instruction
set also includes all MVS/XA instructions.
PRIV Includes privileged instructions in the instruction set.
NOPRIV Does not decode privileged instructions.
REASM Outputs the disassembled instructions in a format that can be
reassembled to recreate the decoded module. When you request this
format, the CSECT offset field (the first output field) is placed at the
end of each decoded statement.
Remarks
READOBJ uses an algorithm that allows several object decks to be present in a single
member. READOBJ formats its output as follows:
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------------------------------------------------------------
-------------------------- ISPMODE Session# 1 Log# 1 ROW 370 TO 387 OF 1,370
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.LIB.DATA,VOL=SER=SER005 MEM=COMPAREC ---------------------------
>----->readobj comparec
00000 COMPARE CSECT
00000 COMPRPCL B 140(,R15) 47F0 F08C *.00.*
00004 BSM R12,R3 0BC3 *.C*
00006 DC C'OMPARE ' D6D4D7C1D9C54040 *OMPARE *
0000E DC C' 06/03' 404040F0F661F0F3 * 06/03*
00016 DC C'/92 13.4' 61F9F240F1F34BF4 */92 13.4*
0001E DC C'8 ' F840 *8 *
00020 B 32(,R10) 47F0 A020 *.0..*
00024 DC X'ABABABABABABABAB' ABABABABABABABAB *........*
0002C DC X'ABABABABABABABAB' ABABABABABABABAB *........*
RECALL Subcommand
The RECALL (or RC) subcommand displays the previous subcommand or displays and
reenters the previous subcommand for execution.
The following subcommands are ignored for the purposes of the RECALL subcommand:
CHANGE, HELP, K (KLEAR), and TSO.
Example
RECALL enter
Syntax
RECALL [ENTER/NOENTER/CHANGE]
Aliases
R, RC, RE, REC, RECA, RECAL, RECALL
Defaults
NOENTER
Required
none
Operands
ENTER Displays and reenters the previous subcommand.
Remarks
In ISPMODE additional options are available to retrieve subcommands from the log.
LASTCMDS allows you to display or select any of the last 32 primary subcommands
entered.
RENAME Subcommand
The RENAME subcommand changes a member’s name.
If you are planning to rename members in a LLA controlled library, see “LLA and Deleted
Members” in Chapter 6, "Commands — L to N".
Example
RENAME thismem thatmem
Syntax
RENAME curname newname [GROUP/NOGROUP ]
[SWAP/NOSWAP ]
[REPBY(repnm) ]
[FORCE ]
Aliases
REN, RENA, RENAM, RENAME
Defaults
NOSWAP, NOGROUP
Required
curname, newname
Operands
curname Specifies the current name of the member.
newname Specifies the new name for the member. This new name becomes
the default member name.
Remarks
If you rename a main load member, any associated alias directory entries are updated to
reflect the new base member name.
If you rename a main load member to itself, any associated alias entries are checked and
updated as needed. A rename of a main member to itself may be useful in completing a
rename sequence for a utility such as ISPF 3.1 or TSO RENAME which leave alias entries
pointing at the original main member name.
NOTE This subcommand modifies the data set. To ensure data set integrity, allocate the
data set as OLD or be aware of the data set update protection provided by the StarTool
FDM command for SHR allocations. For details, see Appendix B, "Update Protection".
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------------------------------------------------------------
--------------------------- ISPMODE Session Display ---------- ROW 286 OF 299
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.LIB.TEST,VOL=SER=STR815 MEM=@OLD:@OLD ------------------------
>----->ren @dia @old group
PDS161I Members to be renamed are: @DIACLIK, @DIAINIT, @DIALOG, @DIAPANL,
@DIAPART, @DIASTAK, @DIATBL, @DIAWRK
REPLACE Subcommand
The REPLACE subcommand changes portions of a member that contains a search string.
Only those portions of the member that contain the search string display after a character
string substitution. For load modules or VSAM data sets, the search and replace strings
must have the same length.
Example
REPLACE mema:memb /before/after/ write
(or equivalently)
REPLACE mema:memb ‘before’ ‘after’ write
(or equivalently)
REPLACE mema:memb xc2c5c6d6d9c5xc1c6e3c5d9x write
Syntax
REPLACE memgroup
+stra+strb+
[NUM/SNUM/NONUM/LBLOCK/LDUMP/BLOCK/DUMP ]
[CAPS/ASIS/IGNORE/PICTURE ]
[STATS/NOSTATS ]
[WRITE/NOWRITE/UPDATE/NOUPDATE ]
[WORD/PREFIX/SUFFIX ]
[OFFSET(Hx) MODULE({* / Fullm / Partm*)} ]
[AFTER(num) DO(num) MAXMEMBERS(num) COLS(from:to) ]
[AND('string2') ACOLS(from:to) ACAPS/AASIS/AIGNORE/APICTURE]
[ORx('string3') OCOLS(from:to) OCAPS/OASIS/OIGNORE/OPICTURE ]
[FORMAT(from:to,from:to, ...) ]
[SKIPREC(n) MAXIN(n) MAXOUT(n) ]
Aliases
REP, REPL, REPLA, REPLAC, REPLACE
Abbreviations
FKEY for FROMKEY, FADDR for FROMADDRESS, FNUM for FROMNUMBER, TKEY for TOKEY,
TADDR for TOADDRESS, and TNUM for TONUMBER.
Defaults
memgroup, previous stringa, IGNORE, NOWRITE, STATS, NUM or previous REPLACE/
FIND/LIST format
Required
none
Operands
memgroup Identifies the members to be scanned and updated.
Default member names, member lists, member name
ranges, and member name patterns are allowed. For more
information, see Appendix A, "Formatting Member Names"
on page 417.
stringa Defines the string to be searched. It is coded as a delimited
string like +searched for+. If the string is not entered or is
null, the last string entered is used. The string can contain
one to 32 characters. If you enter the ASIS keyword, neither
string is translated to upper-case letters.
For LBLOCK, LDUMP, BLOCK, and DUMP formats, the search
and replace strings must have the same lengths.
As an alternative, enter both strings as hexadecimal strings
delimited with x’s like x0123456789xabcdefx. Each string
can contain 1 to 64 characters and that x333x1x and
x0333x01x are equivalent.
Remarks
If you specify the WRITE or UPDATE keyword, the data is updated in-place; otherwise,
only potential changes are listed.
Unprintable characters for 3270-type devices are translated to periods before they are
displayed.
REPLACE formats are NUM, SNUM, NONUM, LBLOCK, LDUMP, BLOCK, and DUMP. For load
modules, the NUM, SNUM, and NONUM formats are equivalent to the LDUMP format and
for VSAM data sets, the NUM, SNUM, and NONUM formats are equivalent to the LBLOCK
format.
The default format is initially NUM; however, each time a format operand is entered on a
REPLACE, FIND, or LIST subcommand, the value entered is used as the output format for
subsequent REPLACE, FIND, and LIST subcommands. Also, note the following:
1 Formats NUM, SNUM, and NONUM limit the search and update length for logical
records to 256 characters.
2 Column 72 is not searched or modified for formats NUM or SNUM if the record format
is fixed with 80 character records since this is the continuation column.
3 Formats BLOCK and DUMP apply to physical records for non-VSAM data sets (or when
control interval processing is being performed). The other formats apply to logical
records. For load modules, LBLOCK and LDUMP formats update and display only
CSECT data.
4 Formats LBLOCK, LDUMP, BLOCK, and DUMP display only the updated segments of a
record that contain the search string; however, a following segment also displays if
the string spans a segment boundary.
5 Formats LBLOCK, LDUMP, BLOCK, and DUMP require equal length search and
replacement strings.
6 Formats NUM, SNUM, and NONUM allow different length strings with string expansion
(shifting the data over to multiple blanks) and string contraction (shifting the data up
to the next blank into the replacement data). The string expansion and contraction
algorithms modify programming language (Assembler, CLIST, COBOL, FORTRAN, ISPF,
PL/I) statements correctly.
7 For VSAM DATA or INDEX components, the LIST, FIND, and REPLACE subcommands
support control interval access using the DUMP or BLOCK display formats. Instead of
accessing individual VSAM records, each GET or PUT obtains a VSAM control interval.
Control interval access is useful if a VSAM data set has logical errors. REPLACE repairs
the error; however, since only the component is opened for update, the next access of
the data set through the related cluster gets warning errors because of the differing
time stamps.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------------------------------------------------------------
-------------------------- ISPMODE Session# 1 Log# 1 -- ROW 452 TO 469 OF 473
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.LIB.CNTL,VOL=SER=SER004 MEM=(TAPEA -----------------------------
>----->replace m:z /pdse221a/pdse310/ sublist
PDS246I NOWRITE is in effect; no updates will be performed
** REPLACE TAPEA
001400 //ICNTL DD DSN=SER07.PDSE310.CNTL,DISP=SHR
001700 //ILOAD DD DSN=SER07.PDSE310.LOAD,DISP=SHR
PDS142I 57 lines in this member
PDS146I 2 strings found
** REPLACE TAPEXOC
002100 //IASSM DD DSN=SER07.PDSE310.ASSEMBLE,DISP=SHR
PDS142I 45 lines in this member
PDS146I 1 strings found
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------------------------------------------------------------
-------------------------- ISPMODE Session# 1 Log ROW 1,000 TO 1,014 OF 1,014
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.LINK.LOAD,VOL=SER=SER007 MEM=PDSDECRY --------------------------
>----->repl pdsdecry x4780c1x4770c1x
PDS246I NOWRITE is in effect; no updates will be performed
** REPLACE PDSDECRY
PDS141I AT 000000 CSECT ENCRYPT LENGTH 000015E0
000180 0180 C1D9E240 5000F000 0A0612FF 4770C1A4 *ARS &.0.......Au*
0001B0 01B0 30509180 40064770 C1D248E0 400406E0 *.&j. ...AK...
0001E0 01E0 4770C1FC 48E04004 06E05810 400047F0 *..A..... ..0*
FUNCTIONS CONTROL DSN CMDS DATA CMDS A-M DATA CMDS N-Z DEFAULT FEATURE
------------------------------------------------------------------------------
-------------------------- ISPMODE Session# 1 Log ROW 1,000 TO 1,012 OF 1,012
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.VSAM.IS.CLUSTER,VOL=SER=SER007 ----------------------------------
>----->repl 'cylx' 'cyly' block write
PDS140I BLOCK RECORD 6 LENGTH 80 RBA 00000400
000XX000 000 *000XX000 IF &CYLY = &STX() THEN - *
REPRO Subcommand
The REPRO subcommand rebuilds members. It can also create new members based on
existing members in the data set. REPRO cannot reblock load members.
Example
REPRO mem1:mem2 maxblk(2400)
Syntax
REPRO memgroup [ADDZAP/ADDZAP(numb) ]
[ALIAS/NOALIAS ]
[CALL/NOCALL ]
[SUMMARY/LIST/NOLIST ]
[MAXBLK(size) ]
[REPLACE/NOREPLACE ]
[TO(pname) / AS(pname)]
Aliases
REPR, REPRO
Defaults
memgroup, MAXBLK(current BLKSIZE), NOREPLACE, ALIAS for load members unless AS
or TO is entered; otherwise NOALIAS.
Required
none
Operands
memgroup Identifies the members to be rebuilt (or used as input for new
members).
Default member names, member lists, member name ranges,
and member name patterns are allowed. For more information,
see Appendix A, "Formatting Member Names".
ADDZAP For load members only, adds a ZAP IDR record (each ZAP IDR
record contains space for 19 historical entries).
ADDZAP(numb) For load members only, adds 1 to 99 ZAP IDR records.
ALIAS Processes any associated members (aliases, apparent aliases,
and associated main members too).
NOALIAS Processes only specifically identified members.
CALL Specifies that the copy program is to be invoked.
NOCALL Specifies that the copy program is not to be invoked; member
checking and data set allocations are still performed.
SUMMARY Specifies that only summary and error messages are to be
displayed.
LIST Specifies that all messages are to be displayed.
NOLIST Specifies that no messages are to be displayed.
MAXBLK(sz) For RECFM=V or RECFM=F members only, specifies the maximum
output block size to be used when the members are
reconstructed.
REPLACE For use with AS or TO only, replaces current members in the data
set with any identically named output members.
NOREPLACE For use with AS or TO only, generates an error message and
terminates if any members in the data set will be replaced by any
identically named output members.
TO(pname) pname defines output member name prefixes. For example, with
TO(new) and the input members, AA, ABBA, and IBM04,
members named NEW, NEWA, and NEW04 are created (the
original members are not changed).
If only a single member is input and the ALIAS keyword is not
entered, the resulting member name is taken only from the AS or
TO keyword.
AS(pname) pname defines output member name prefixes. For example, with
AS(new) and the input members, AA, ABBA, and IBM04,
members named NEW, NEWA, and NEW04 are created (the
original members are not changed).
If only a single member is input and the ALIAS keyword is not
entered, the resulting member name is taken only from the AS or
TO keyword.
Remarks
If you use the TO (or the equivalent AS) keyword, each new member is named in a
generic fashion. For example, if you enter TO(X12), each resulting member name is
formed by placing X12 over the first three characters of the original member name. An
exception to this rule is made when only a single member is to be created and its aliases
are not also requested. In this case, the member name is taken directly from the TO
keyword.
For load members, a null ZAP IDR record can be added when the member is rebuilt; for
non-load members, the member can be reblocked as specified by the MAXBLK keyword.
NOTE This subcommand modifies the data set. To ensure data set integrity, allocate the
data set as OLD or be aware of the data set update protection provided by the StarTool
FDM command for SHR allocations. For details, see Appendix B, "Update Protection" on
page 421.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------------------------------------------------------------
-------------------------- ISPMODE Session# 1 Log# 1 -- ROW 145 TO 152 OF 152
COMMAND ===> SCROLL ===> CSR
Enter an ISPF command, a StarTool subcommand or a special control code:
- DSN=WSER07.LIB.CLISTV,VOL=SER=STR92T MEM=BC:BC6 -------------------------
>----->repr aa* to(bc) repl
PDS051I BC was replaced; input=1; output=1
PDS051I BCAA was created; input=6; output=6
PDS051I BCC was replaced; input=44; output=44
PDS051I BC2 was created; input=1; output=1
PDS051I BC4 was created; input=34; output=34
PDS051I BC5 was created; input=1; output=1
PDS051I BC6 was created; input=90; output=90
****************************** BOTTOM OF DATA *******************************
RESTORE Subcommand
The RESTORE subcommand resurrects deleted members (deleted members are physically
present in a partitioned data set until the data set is compressed). Former versions of a
changed member are also available for RESTORE. RESTORE is not supported for PDSE
data sets.
If you use the MEMLIST (or ML) operand to restore deleted members into a MEMLIST
library, several MEMLIST line commands are available to help you examine and
manipulate deleted members.
Example
RESTORE str memlist find(‘mydata’)
Syntax
RESTORE member [COUNT(number) ]
[DISPLAY/NODISPLAY ]
[FIND('any string') ]
[ASIS/IGNORE ]
[LIKE(xyz) ]
[MODULE({* / Fullm / Partm*)}]
[PROMPT/NOPROMPT ]
[REPEAT/NOREPEAT/MEMLIST ]
[STATS/NOSTATS ]
[TTR(start) ]
Aliases
RES, REST, RESTO, RESTOR, RESTORE
Defaults
COUNT(5), DISPLAY, PROMPT, STATS, TTR(0)
Required
member
Operands
member Specifies a name for the member to be resurrected. This member name
becomes the default member name after the member is restored.
COUNT Displays at most num informational lines from a deleted member.
(num)
DISPLAY Displays data from deleted members.
NODISPLAY Does not display data from deleted members.
FIND('any') Considers only deleted members containing the string ANY. If ANY is
not present in a deleted member, that member is not to be displayed or
resurrected.
ASIS For use with FIND, does not translate the FIND string to upper case.
IGNORE For use with FIND, searches for upper- and lower-case string
arguments.
LIKE(xyz) For load modules, bases the following attributes on their corresponding
values from member XYZ: AMODE, authorization, editable, executable,
only loadable, page aligned, reentrant, refreshable, reusable, RMODE,
and SSI. For source members, base any SSI value or ISPF statistics on
those present for member XYZ.
MODULE Specifies a 1- to 8-byte partial external name that limits candidates for
(name) restore processing. If the name parameter is not satisfied for any
CSECT or ENTRY symbols in a deleted member, that member is not to
be displayed or resurrected.The MODULE operand has several valid
forms:
MODULE(*) – uses the previous name entered on any MODULE keyword
MODULE(Fullm) – considers only deleted members containing a CSECT
or ENTRY called FULLM
MODULE(Partm*) – considers only deleted members containing a
CSECT or ENTRY called PARTM...
PROMPT Requires a YES response to a StarTool FDM prompt before restoring a
deleted member.
NOPROMPT Does not prompt before restoring a deleted member.
REPEAT Restores one or more deleted members. The member name to be used
is taken from the partial member name entered filled to eight
characters by a sequential count field. For example, if you enter
RESTORE GASM REPEAT, the restored member names will be
GASM0001, GASM0002, GASM0003, ...
NOREPEAT Restores at most one member.
MEMLIST Restores deleted members into the MEMLIST. Member names are
generated from the partial member name provided and filled with a
count as for the REPEAT option. These members are not actually
restored; they are marked as *DELETED and placed in the MEMLIST so
that you can examine them with line commands DELINK, DISASM,
FIND, HISTORY, LIST, MAP, and REVIEW. Use the RESTORE line
command to restore these deleted members.
STATS For source members, creates ISPF statistics for the restored member.
NOSTATS Does not create ISPF statistics for the deleted member.
TTR(strt) Identifies the starting TTR address (in 1 to 6 hexadecimal digits) of the
deleted member. If REPEAT/MEMLIST, DISPLAY, or PROMPT are in
effect, strt is the starting TTR address for a deleted member search.
If you specify TTR(0) is specified or defaulted, the member search
begins at the first location following the directory.
Remarks
For maximum effectiveness in restoring deleted members use the FIND keyword to limit
the number of displays and prompts. In addition, for load libraries, use the MODULE
keyword to screen members by CSECT and ENTRY names. Combine these keywords with
the MEMLIST option (which forces NOPROMPT) to bring deleted members into the
MEMLIST only. Members are restored individually with the RESTORE line command.
The load attributes authorized, not editable, not executable, only loadable, page
boundary, reentrant, refreshable, and reusable cannot be determined from load module
records. These attributes can be assigned based on a model member with the LIKE
operand or they can be selectively assigned by the subcommand later.
If REPEAT/MEMLIST, DISPLAY, or PROMPT are in effect, StarTool FDM searches for deleted
members and changes the normal RESTORE behavior:
3 If PROMPT is in effect, StarTool FDM requires that you decide what to do with each
deleted member.
To restore the deleted member, reply with YES
To not restore the deleted member, reply with NO. The next deleted member is then
presented to you
To terminate the RESTORE subcommand with no further prompting, reply with CAN
If the data set is a load library, and if the member name is an imbedded external name
within the load module, then that external name is used as the entry point; otherwise, the
first CSECT in the load module is used as the entry point.
It may be possible to resurrect members that were deleted before compressing a data set
if you mark all of the data set’s space as in-use with a FIXPDS MAXSPACE command
before the restore attempt.
It may also be possible to resurrect members lost from a PDS after the directory is
overwritten by sequential output due to some sort of JCL or procedural error. The
sequential data blocks take one or more tracks followed by the end of file marker in the
disk tracks formerly occupied by the directory. To attempt recovery of PDS members
located after the overwritten tracks, type:
1 FIXPDS MAXSPACE
(to mark all allocated space in use)
4 VERIFY :
(to find invalid members after the previous DS1LSTAR)
5 BROWSE name
(to scan contents of members)
7 DELETE name
(to delete members not needed)
8 COMPRESS
(to clean up unused space again)
NOTE This subcommand modifies the data set. To ensure data set integrity, allocate the
data set as OLD or be aware of the data set update protection provided by the StarTool
FDM command for SHR allocations. For details, see Appendix B, "Update Protection".
RESTORE bbb memlist find('vsam') produces this sample from a source library.
FUNCTIONS CONTROL A-M LINE CMDS A-M DSN CMDS MEM CMDS A-M FEATURES
CONTROL N-Z LINE CMDS N-Z MEM CMDS N-Z DEFAULTS
--------------------------- Source MEMLIST 1, Session# 2 ------ ROW 1 TO 9 OF 9
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.LIB.CNTL,VOL=SER=SER006 MEM=BBB:BBB ----------------------------
CMD NAME DATA/MSG VER.MOD CREATED LAST MODIFIED SIZE INIT ID
A 01.00 93/04/08 93/04/12 13:21 5 5 SER07
ABLK 01.01 93/04/09 93/04/05 14:37 6 9 SER07
BBB00001 *DELETED 01.00 93/04/20 93/04/20 10:10 24 24 *DELETE
BBB00002 *DELETED 01.00 93/04/20 93/04/20 10:10 12 12 *DELETE
rest BBB00003 vsam#mem 01.00 93/04/20 93/04/20 10:10 3 3 *DELETE
BBB00004 *DELETED 01.00 93/04/20 93/04/20 10:10 25 25 *DELETE
LOADMARK 01.02 93/02/26 93/04/25 6:43 50 48 SER07
SAMPSECR 01.26 90/03/27 93/04/01 5:57 197 220 SER07
TRIAL601 01.00 93/04/14 93/04/20 15:16 123 123 SER07
****************************** BOTTOM OF DATA ********************************
RESTORE $$$$ memlist module(pdsmain) produces this sample from a load library.
FUNCTIONS CONTROL A-M LINE CMDS A-M DSN CMDS MEM CMDS A-M FEATURES
CONTROL N-Z LINE CMDS N-Z MEM CMDS N-Z DEFAULTS
------------------------- Load MEMLIST 1, Session# 2 ------- ROW 1 TO 4 OF 4
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.LINK.LOAD,VOL=SER=SER007 MEM=$$$$:$$$$ -------------------------
CMD NAME DATA/MSG ALIASOF LEN/LKED -- UTES -- APF MODE MAIN
map $$$$0001 *DELETED 93/04/12 *DELETED
$$$$0002 *DELETED 93/04/15 *DELETED
rest $$$$0003 *DELETED 93/04/16 *DELETED
STARTOOL *REPRO* 93/04/16 RENT REUS
******************************* BOTTOM OF DATA *******************************
REVIEW Subcommand
The REVIEW subcommand browses data. Use the TSO REVIEW command. Any REVIEW
operands can be added after the member name. REVIEW operates independently of ISPF.
Example
REVIEW mema:memb
Syntax
REVIEW memgroup [operands]
Aliases
REV, REVI, REVIE, REVIEW
Defaults
none
Required
none
Operands
memgroup Identifies the members to be browsed.
Default member names, member lists, member name ranges, and
member name patterns are allowed. For more information, see
Appendix A, "Formatting Member Names" on page 417.
If the memgroup is specified as a : (for all members), the REVIEW
command is called to provide a member selection list.
operands Optional. Can include any TSO REVIEW operands.
Remarks
This interface is optional. Use it only if your installation installed the public domain
REVIEW command.
Recent versions of the REVIEW command operate in seven-color mode. REVIEW can
display VSAM data sets. In a MEMLIST, use REV as a line command to display deleted
members before they are restored.
SEPARATE Subcommand
The SEPARATE subcommand splits a member or data set containing members with ./
separators into their component members. ISPF statistics are maintained.
Example
SEPARATE anymemb output.data.set
Syntax
SEPARATE member dsname
[VOLUME(volser) ]
[SEPCHAR(dd) ]
[TRANSFROM(ab) ]
[TRANSTO(cd) ]
[CALL/NOCALL ]
[SUMMARY/LIST/NOLIST]
[OLD/SHR / NEW [BLK/TRK/CYL]
[DIR(num)] [SPACE sec)]]
[ROUND] [EXPDT(yyddd)/RETPD(nnnn)] [RLSE]
[STORCLAS(sclass)] [MGMTCLAS(mclass)]
[DATACLAS(dclass)] [DSNTYPE(LIBRARY/PDS)]
Aliases
SEP, SEPA, SEPAR, SEPARA, SEPARAT, SEPARATE
Defaults
SHR, SEPCHAR(./)
Required
member, dsname
Operands
member Identifies the member that contains the input for the
SEPARATE function.
dsname Identifies the output data set. Use Standard TSO syntax.
VOLUME(volser) Identifies the volume name for output data sets that are not
cataloged.
SEPCHAR(dd) Names the delimiter to be expected between members
(usually ./).
TRANSFROM(ab) Defaults to <>. Specifies a character string that is translated
to the TRANSTO string if found in column one of the input
stream.
TRANSTO(ab) Defaults to ./. Specifies a character string that is substituted
for the TRANSFROM string if found in column one of the input
stream.
CALL Invoke the copy program.
NOCALL So not invoke the copy program. Member checking and data
set allocations are still performed.
SUMMARY Display only summary and error messages.
LIST Display all messages.
NOLIST Do not display messages.
OLD Obtains exclusive use of the output data set.
SHR Allows shared use of the output data set. StarTool FDM
provides output data set protection. see Appendix B, "Update
Protection" on page 421.
NEW Creates the output data set. When you specify NEW, you
may also specify BLK/TRK/CYL, DIR, SPACE, ROUND, EXPDT
(or RETPD), RLSE, STORCLAS, MGMTCLAS, DATACLAS, and
DSNTYPE keywords.
DIR(num) The number of directory blocks for the output data set. If
DIR is not entered, the default is taken from the input data
set.
SPACE(prim,sec) The primary and secondary quantities for the output data set
in track or cylinder units.
If BLK, TRK, or CYL is not entered but SPACE is entered, the
space allocation units are assumed the same as the current
allocation.
BLK Allocates the output data set in blocks. If BLK is entered
without SPACE, the space allocation units are taken from the
current allocation and converted to equivalent block units.
TRK Allocates the output data set in tracks. If TRK is entered
without SPACE, the space allocation units are taken from the
current allocation and converted to equivalent track units.
CYL Allocates the output data set in cylinder units. If CYL is
entered without SPACE, the space allocation units are taken
from the current allocation and converted to equivalent
cylinder units.
ROUND Used with BLK to specify that the data set allocation be
rounded up to cylinder boundaries.
EXPDT(yyddd) The expiration date for the data set. On and after the
expiration date, you can delete or write over the data set.
You can also use the format EXPDT(yyyyddd).
RETPD(nnnn) The number of days (0 to 9999) that the data set be retained
by your data center.
RLSE Release any unused space in the data set after the copy
operation.
STORCLAS(sc) The storage class for the data set. Use this parameter to
identify performance and availability requirements for data
sets. Use this parameter instead of UNIT and VOLUME
keywords for SMS managed data sets to determine where
the data set is allocated. To nullify this parameter, type
STORCLAS(*).
MGMTCLAS(mc) The management class for the data set. This parameter
establishes the migration, backup and space release
characteristics for SMS managed data sets. To nullify this
parameter, type MGMTCLAS(*).
DATACLAS(dc) The data class for the data set. Use this parameter to
provide data attributes such as RECFM, KEYLEN, SPACE,
EXPDT or RETPD, DSORG, LRECL and some VSAM SHR
options for SMS managed data sets. To nullify this
parameter, type DATACLAS(*). Use DATACLAS for data sets
that are not SMS managed.
DSNTYPE(typ) Specify typ as LIBRARY for a PDSE or PDS for a partitioned
data set. A PDSE must be a SMS-managed data set.
Remarks
The SEPARATE subcommand splits apart members that were joined with a COMBINE
subcommand using an IEBUPDTE (or the default) keyword.
ISPF statistics are preserved if possible and any >< control statements in a member are
converted to ./ control statements.
COMBINE and SEPARATE are paired subcommands. To join members into a combined
member or data set, use the COMBINE subcommand. To split the members apart again,
use the SEPARATE subcommand or IEBUPDTE if the logical record length is 80.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------- ISPMODE Session# 1 Log# 1 --- Row 547 to 557 of 557
COMMAND ===> SCROLL ===> CSR
- DSN=WSER07.LIB.CNTL,VOL=SER=SER001 MEM=(#MDSECT -------------------------
>------>separate download lib.pdse
PDS290I SEPARATE is in progress
PDS051I #MDSECT was replaced; input=1,657; output=1,656
PDS051I @FILEXID was replaced; input=5,853; output=5,852
PDS051I @FILEPAR was replaced; input=2,265; output=2,264
PDS051I @SERVICE was replaced; input=5,686; output=5,685
PDS051I @VERIFY was replaced; input=1,954; output=1,953
PDS051I PDS0520 was created; input=473; output=472
SMPGEN Subcommand
The SMPGEN subcommand assists in creating SMP/E sysmods. While only ++MAC,
++MACUPD, ++MOD (with appropriate ++JCLIN), ++SRC, ++SRCUPD statements are
generated, complete SMP/E functions with an editor by using SMPGEN output as a basis
for the sysmod.
In each case, begin with a library; MOD supports source libraries (assumed to be object
code) and load libraries (assumed to be the final form of each load module). Choose one
of the primary operand types (MAC, MACUPD, MOD, SRC, or SRCUPD) and other operands
as appropriate.
To generate a generic data type, use the MAC and TYPE keywords as in following example.
Example
SMPGEN : MAC distlib(apdspan) syslmod(pdspan) relfile(3) type(panel)
Syntax
SMPGEN memgroup
MAC DISTLIB(ddname) [SYSLIB(ddname)]
[SSI(hexdata)] [TYPE(name)]
TXLIB(ddname) / RELFILE(number) / INLINE
Aliases
SM, SMP, SMPG, SMPGE, SMPGEN
Defaults
memgroup, TYPE(MAC)
Required
DISTLIB and either MAC, MACUPD, MOD, SRC, or SRCUPD
Operands
memgroup Identifies the group of members for which SMP/E control statements
are wanted.
Default member names, member lists, member name ranges, and
member name patterns are allowed. For more information, see
Appendix A, "Formatting Member Names" on page 417.
MAC Defines MACRO elements with ++MAC statements. Data is included
after each MAC statement if INLINE is specified; otherwise, either
TXLIB or RELFILE is required.
MACUPD Defines MACRO element updates with ++MACUPD statements. Data is
included inline after each MACUPD statement. SMP/E assumes input
data has valid IEBUPDTE sequence numbers.
MOD Defines load or object elements with ++MOD statements. In a load
library, JCLIN data is generated and a SYSLMOD operand is required.
The INLINE keyword is supported for load libraries; otherwise, enter
TXLIB, LKLIB, or RELFILE.
In an object library, specify the name of a member that contains SMP/
E JCLIN for inclusion in the generated data with the JCLIN operand.
Choose to include each object deck after the MOD statement by
specifying INLINE or you may use TXLIB, LKLIB, or RELFILE.
SRC Defines source elements with ++SRC statements. Data is included
after each SRC statement if INLINE is specified; otherwise, TXLIB or
RELFILE is required.
SRCUPD Defines source element updates with ++SRCUPD statements. Data is
included inline after each SRCUPD statement. SMP/E assumes input
data has valid IEBUPDTE sequence numbers.
DISTLIB Adds DISTLIB(dd) to each generated SMP/E control statement to
(dd) specify the DDNAME of the distribution library. The DISTLIB operand is
always required for a SMPGEN subcommand.
SYSLIB(dd) Adds SYSLIB(dd) to each generated SMP/E control statement to
specify the DDNAME of the target system library. The SYSLIB operand
is always optional for a SMPGEN subcommand.
SSI Adds SSI(hexdata) to each generated SMP/E control statement to
(hexdata) specify system status information. The SSI operand is always optional
for a SMPGEN subcommand. The SSI operand is ignored by SMP/E
unless data is included inline.
TXLIB(dd) Adds TXLIB(dd) to each generated SMP/E control statement to specify
the DDNAME where MAC, MOD or SRC elements reside.
RELFILE Adds RELFILE(num) to each generated SMP/E control statement to
(num) specify the relative number of the SMP/E relative file where MAC,
MOD, or SRC elements reside.
LKLIB(dd) Adds LKLIB(num) to each generated SMP/E control statement to
specify the DDNAME where the load module MOD elements reside.
INLINE Generates MAC, MOD, or SRC elements inline.
CSECT Use the CSECT keyword with INLINE and MOD for a load library.
++MOD statements are placed in the delinked input on CSECT
boundaries.
LINK Default for MOD. Generates linkage-editor control statements.
COPY Optional for MOD. Generates IEBCOPY control statements.
CSLIST Optional for MOD. Generates all CSECT names with a CSECT keyword.
SYSLMOD Adds the specified name in the generated JCLIN for each SYSLMOD
(name) statement. This operand is required for load module libraries. As an
example, if SYSLMOD(PDSLOAD) were specified, SYSLMOD
statements similar to the following are generated:
//SYSLMOD DD DISP=SHR,DSN=SYS1.PDSLOAD
JCLIN Adds the specified member contents to the generated SMP/E control
(member) statements after a ++JCLIN statement.
This operand is not allowed for load module libraries and it is optional
for object libraries—the member must be located in the same library
as your object modules.
DISTMOD Adds DISTMOD(dd) to each generated SMP/E control statement to
(dd) specify the DDNAME of the link edit distribution library for object code
produced from the assembly of source code.
TYPE Changes generated SMP/E control statements from ++MAC to
(name) ++name. For example, to generate ++PANEL statements, code
TYPE(PANEL).
Remarks
The SMPGEN subcommand assists you in preparing SMP/E SYSMODs. It creates the basic
framework of the required individual elements. You add other SMP/E control statements
to create a valid FUNCTION, APAR, PTF or USERMOD.
The SMPGEN subcommand generates JCLIN statements for load modules or MALIAS
statements for ++MAC elements.
Many valid SMP/E keywords are not supported for the different element types. Generally,
only those keywords that apply to an entire library are supported. If a specific operand is
required for a specific member, choose to change the generated statements after the
SMPGEN process with an editor. The following SMP/E keywords are not supported:
1 The data set directory is processed to include any aliases of the member group to be
processed.
2 Error messages are issued before any output is generated to assist you in correcting
errors.
MACUPD elements are always generated inline. Alias members are ignored by
StarTool FDM.
MOD elements from an object library are generated inline if the INLINE keyword is in
effect. If the JCLIN operand is specified, a ++JCLIN statement is generated just
before displaying the data from the JCLIN member specified.
++MOD elements from an load library also are generated inline using a delinked
load module. The load modules are examined to generate appropriate JCLIN
statements.
For load and object libraries, ++MOD statements are not generated for alias
members since they are defined to SMP/E through the JCLIN.
++SRC elements are generated inline if the INLINE keyword is in effect. Alias
members are not allowed.
++SRCUPD elements are always generated inline. Alias members are ignored by
StarTool FDM.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
-------------------------- ISPMODE Session# 2 Log ROW 1,000 TO 1,025 OF 1,086
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.PDSE311.PANELS,VOL=SER=SER006 MEM=PDSZ* ------------------------
>----->smpgen pdsz* mac distlib(panlib) type(panel) relfile(3)
++PANEL(PDSZA@C ) DISTLIB(PANLIB) RELFILE(3) .
++PANEL(PDSZA@P ) DISTLIB(PANLIB) RELFILE(3) .
++PANEL(PDSZABA ) DISTLIB(PANLIB) RELFILE(3) .
++PANEL(PDSZABE ) DISTLIB(PANLIB) RELFILE(3) .
++PANEL(PDSZAFTZ) DISTLIB(PANLIB) RELFILE(3) .
++PANEL(PDSZAID ) DISTLIB(PANLIB) RELFILE(3) .
++PANEL(PDSZALIA) DISTLIB(PANLIB) RELFILE(3) .
++PANEL(PDSZALLO) DISTLIB(PANLIB) RELFILE(3) .
++PANEL(PDSZALOC) DISTLIB(PANLIB) RELFILE(3) .
++PANEL(PDSZAOF ) DISTLIB(PANLIB) RELFILE(3) .
++PANEL(PDSZATB ) DISTLIB(PANLIB) RELFILE(3) .
++PANEL(PDSZATTR) DISTLIB(PANLIB) RELFILE(3) .
++PANEL(PDSZATU ) DISTLIB(PANLIB) RELFILE(3) .
++PANEL(PDSZAUTH) DISTLIB(PANLIB) RELFILE(3) .
++PANEL(PDSZAZA ) DISTLIB(PANLIB) RELFILE(3) .
++PANEL(PDSZBROW) DISTLIB(PANLIB) RELFILE(3) .
++PANEL(PDSZCREA) DISTLIB(PANLIB) RELFILE(3) .
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
--------------------------- ISPMODE Session Display ------------ ROW 15 OF 94
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.PDSE.ASMBLR,VOL=SER=STR804 MEM=PDS#S* ------------------------
>----->smpgen pds#s* mac inline distlib(pdsasmb)
++MAC(PDS#SIZE) DISTLIB(PDSASMB)
.
MACRO
&MD PDS#SIZE &SPFSIZE=1000, /* SIZE OF DIALOG DISPLAY TABLE */X
&SPFMAX=2000, /* MAXIMUM LINES FOR A SUBCOMMAND */X
&SPFCKPT=250, /* LINES BETWEEN CHECKPOINTS */X
&TRPSIZE=3000 /* MAXIMUM LINES TO TRAP */
GBLA &SIZECNT
GBLC &SIZES(4)
&SIZES(1) SETC '&SPFSIZE'
&SIZES(2) SETC '&SPFMAX'
&SIZES(3) SETC '&SPFCKPT'
&SIZES(4) SETC '&TRPSIZE'
&SIZECNT SETA 4
MEND
++MAC(PDS#SOPT) DISTLIB(PDSASMB)
.
MACRO
&MD PDS#SOPT &LKEDDAT=Y, /* DEFAULT LKEDDATE IN MEMLIST? */X
&SPFTDEL=Y, /* DROP DELETED ELEMENTS-MEMLIST? */X
&SPFTOLD=Y, /* DROP RENAMED ELEMENTS-MEMLIST? */X
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
--------------------------- ISPMODE Session Display ----------- ROW 87 OF 163
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.LINK.LOAD,VOL=SER=STR804 MEM=PDS9* ---------------------------
>----->smpgen pds9* mod syslmo(pdsload) distlib(apdsload) lklib(pdsload)
++MOD(PDS98 ) DISTLIB(APDSLOAD) LKLIB(PDSLOAD)
.
++MOD(PDS99A ) DISTLIB(APDSLOAD) LKLIB(PDSLOAD)
.
++MOD(PDS99HL ) DISTLIB(APDSLOAD) LKLIB(PDSLOAD)
.
++JCLIN .
//LKED EXEC PGM=IEWL,
// PARM='NCAL,MAP,LIST,LET,RENT,REUS,REFR'
//SYSUT1 DD UNIT=SYSDA,SPACE=(2048,(200,20))
//SYSPRINT DD SYSOUT=*
//SYSLIB DD DISP=SHR,DSN=SYS1.APDSLOAD
//SYSLMOD DD DISP=SHR,DSN=SYS1.PDSLOAD
//SYSLIN DD *
INCLUDE APDSLOAD(PDS98)
ORDER PEMMAIN(P),PEMPDSIN,PEMATTNX,PEMSTAEX,PEMALLOC,PEMEXCP
ORDER PEMMSGS,PEMPARSE,PEMPARSX,PEMOPTIO,PEMDATEX,PEMDSNX,PEMMEMBR
ORDER PEXMAIN,PEXALIAS,PEXATTR,PEXBROWS,PEXCOMPA,PEXCOMPR,PEXCONT
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
--------------------------- ISPMODE Session Display ---------- ROW 160 OF 200
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.LIB.CNTL,VOL=SER=STR806 MEM=@DIA* ----------------------------
>----->smpgen @dia* src distlib(pdselib) relfile(003)
++SRC(@DIABUG ) DISTLIB(PDSELIB) RELFILE(003)
.
++SRC(@DIACAX ) DISTLIB(PDSELIB) RELFILE(003)
.
++SRC(@DIACLN ) DISTLIB(PDSELIB) RELFILE(003)
.
++SRC(@DIAFIND) DISTLIB(PDSELIB) RELFILE(003)
.
++SRC(@DIAFUN ) DISTLIB(PDSELIB) RELFILE(003)
.
++SRC(@DIAINIT) DISTLIB(PDSELIB) RELFILE(003)
.
++SRC(@DIALALV) DISTLIB(PDSELIB) RELFILE(003)
.
++SRC(@DIALINE) DISTLIB(PDSELIB) RELFILE(003)
.
++SRC(@DIAOUT ) DISTLIB(PDSELIB) RELFILE(003)
.
SUBLIST Subcommand
The SUBLIST subcommand forms lists (or sublists) of members. When SUBLIST gains
control, it forms a new default member group using the individual member names passed
to it; each subcommand that invokes SUBLIST defines a new member sublist.
For example, if a data set contains members MEMABC, MEMXYZ, MEM33 and MEZ4,
entering the command SUBLIST MEM* changes the PDS300A message MEM= keyword to
MEM=(MEMABC. The default member group is the list of individual member names
MEMABC, MEMXYZ, MEM33 and MEZ4 instead of the rule, MEM*, that is usual with
StarTool FDM subcommands.
Example
IF amx/ noalias then(sublist)
PRINT * form(dx00) nohead
COPY * other.library alias
DELETE * alias
Syntax
SUBLIST memgroup [ALIAS/NOALIAS ]
[REVERSE ]
[EXCLUDE(mem*name) ]
[ONLYALIAS/ONLYMAIN ]
[NOBLDL ]
Aliases
SUBL, SUBLI, SUBLIS, SUBLIST
Defaults
memgroup, NOALIAS
Required
none
Operands
memgroup Identifies the group of members whose names are to be defined as
a list of members.
Default member names, member lists, member name ranges, and
member name patterns are allowed. For more information, see
Appendix A, "Formatting Member Names" on page 417.
ALIAS Also adds any associated members (aliases, apparent aliases, and
associated main members) to the sublist of members.
NOALIAS Adds only specifically identified member names to the sublist of
members.
REVERSE Inverts the member list to include members from the data set but
not in the member list.
EXCLUDE Drops members matching the combination name from the sublist.
(mem*name)
ONLYALIAS Forces ALIAS on and adds associated members (aliases, apparent
aliases, and associated main members) to the sublist of members.
Then, the main members are dropped from the sublist leaving only
aliases.
ONLYMAIN Forces ALIAS on and adds associated members (aliases, apparent
aliases, and associated main members) to the sublist of members.
Then, the alias members are dropped from the sublist leaving only
main members.
NOBLDL Specifies that the existence of each member in the current group
need not be verified with a BLDL macro.
This parameter is intended for high performance applications in
conjunction with the MEMBERS subcommand.
This keyword permits processing a list of members without
discarding members that are not present.
Remarks
The SUBLIST subcommand disregards duplicate member names.
If multiple operations are to be performed to the same list of members, they can be
organized as a single member group using the SUBLIST subcommand.
SUBLIST is useful for the THEN or ELSE keywords of the IF and FIND subcommands.
Operands are not supported after the subcommand name (in the THEN or ELSE operand).
However, if you use SUBLIST as the subcommand, a following subcommand (which uses
an * for the group name) can have any operands.
SUBLIST is also useful for the THEN or ELSE keywords of the IF and FIND subcommands
for situations where a refined sublist is being built. For example, to print all members
named A11...XM or MEZ... with ISPF statistics which were saved in the last year and do
not contain the character string NOTME, the following StarTool FDM subcommands suffice:
SUBMIT Subcommand
The SUBMIT subcommand submits a JCL member. Use the TSO SUBMIT command.
Specify any SUBMIT operands after the member name.
Example
SUBMIT mema:memb
Syntax
SUBMIT memgroup [operands]
Aliases
SU, SUB, SUBM, SUBMI, SUBMIT
Defaults
memgroup
Required
none
Operands
memgroup Identifies the members to be submitted for background processing.
Default member names, member lists, member name ranges, and
member name patterns are allowed. For more information, see
Appendix A, "Formatting Member Names" on page 417.
operands Optional. May include any desired TSO SUBMIT operands.
Remarks
This interface is optional. Use it only as an interface to the TSO Submit command.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------------------------------------------------------------
--------------------------- ISPMODE Session Display -------------- ROW 1 OF 6
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.LIB.CNTL,VOL=SER=STR802 MEM=PDSET* ---------------------------
>----->sub pdsback
>----->sub pdset*
PDS165I Members are: PDSETT1A, PDSETT1D, PDSETT1I, PDSETT1M, PDSETT1P,
PDSETT1S
STATUS Function
The STATUS command displays the status of the ISPMODE functions associated with the
CALC, CAX, CMDTBL, CSECTS, HEX, GO, LISTA (or DDNAME), LISTC (or LISTF), LISTV,
LOG, MEMLIST, PBROWSE, PEDIT, WORKPAD, and ZAP functions.
Example
STATUS
Syntax
STATUS
Aliases
ST, STA, STAT, STATU, STATUS
Operands
No operands are supported for the STATUS command.
Remarks
The STATUS display shows the status of all current ISPMODE functions in response to a
STATUS command or a STATUS response from the END confirmation panel.
In StarTool FDM each function is available concurrently. This means that as you create
functions (log tables, MEMLIST tables, LISTA/DDNAME tables, LISTC/LISTF tables, and so
on) you can go from one to another without exiting the current function. When you select
a function, you are placed back in it automatically. For example, in the log, you are placed
at the top of the log for the last command. If, however, you had previously repositioned
the log and you select it again with no log output additions, StarTool FDM places you at
the same point again. With table panels, StarTool FDM returns you to the place at which
you left the table unless one or more line commands acted on the table; in that case,
positioning is for the last selected item.
A StarTool FDM function remains ACTIVE because the display table and related status
information is retained even if you go to a different table. Functions that have never been
selected or have been deleted are marked INACTIVE. You can activate such functions by
selecting them and supplying any information required for initialization.
The final status possible is PENDING. PENDING indicates that the associated function has
one or more incomplete line commands. If you select the function by entering its name,
you direct the first pending line command to complete. Also, the STATUS function allows
you to cancel pending line commands by function.
As noted above, one method of continuing a PENDING line command is to explicitly select
the function by name. This allows the current line command to complete and initiates the
next line command in that function. If no other line commands are pending, you will go to
the display for the selected function.
Another way to select PENDING line commands for processing is the END command.
When an END command is issued, pending functions are selected for processing using a
dynamic hierarchical structure in the order shown in the STATUS function display: LOG,
ZAP, CSECTS, MEMLIST, LISTA (or DDNAME), LISTC (or LISTF), LISTV, CAX, WORKPAD,
CALC, HEX, CMDTBL, PBROWSE, and PEDIT. If there are no pending functions and END
was issued from one of the table displays, END positions you to the log screen. If END was
issued from a log screen and no line commands are pending, StarTool FDM treats the END
as a request to exit the program. By default, StarTool FDM displays an END Confirmation
panel and continues or terminates based on your response to the END Confirmation panel
(this default can be changed in SETALL).
A final way to select PENDING line commands for processing is the PEND command. When
you issue a PEND command, pending functions are selected for processing using a
dynamic hierarchical structure in the order shown in the STATUS function display below. If
there are no pending functions, PEND has no effect.
Line commands in one function can generate processing for another function. StarTool
FDM dynamically creates a hierarchical relation between the two functions. This is best
illustrated by a line command from a MEMLIST screen whose line command output is
generated in the log. You are placed automatically in the log screen to review the output.
You may not enter additional MEMLIST commands (other than MEMLIST with no
operands) until the pending line command is completed. If you enter MEMLIST or ML with
no operands, MEMLIST completes its line command processing and dynamically removes
the hierarchical relationship with the log.
Note: Functions are shown with the lowest logical function first.
SVCMAP Subcommand
The SVCMAP subcommand formats information regarding the SVC table. SVCs are
extensions to the operating system that are invoked to perform system tasks. SVCs
receive control in supervisor state and in the master storage protect key (key zero). They
have the power to alter otherwise protected storage areas or issue privileged instructions
that cannot be issued directly from problem programs.
If no SVC number is requested, a formatted list of all 256 SVCs is provided. If an SVC
number is specified, only that SVC is formatted. If the SVC is an ESR (router) the ESR
entries are all formatted unless a particular ESR entry is requested.
Type 1 SVCs cannot link to other routines and cannot issue other SVCs from within the
routine. They receive control with the local lock held and can obtain all other locks. They
reside in the system nucleus (IEANUC0x).
Type 2 SVCs can link to other routines and can issue other SVCs themselves. They require
no locks but can issue them. Like type 1 SVCs, they reside in the system nucleus.
Type 3/4 (3 or 4) SVCs can link to other routines and can issue other SVCs. They require
no locks but can issue them. They reside in the Link Pack Area (LPA) or Modified Link Pack
Area (MLPA). They can be loaded from any of the LPA libraries or alternatively, from
SYS1.SVCLIB or SYS1.LINKLIB.
Type 6 SVCs cannot link to other routines or issue other SVCs. They execute disabled,
meaning that no other program can gain control during the execution of the SVC. Locks
cannot be held on entry to the SVC. Like types 1 and 2, type 6 SVCs reside in the system
nucleus.
ESR SVCs are identical in format to the SVC table except for the first eight bytes. The first
3 bytes contain ESR followed by a literal 1, 2, 3, or 6 depending on which SVC type it
contains. The second 4 bytes contain a binary number indicating how many ESR SVCs it
contains.
If the module name output by SVCMAP is ???, this indicates that the module could not be
located in the nucleus, LPA or MLPA. This is usually because the SVC was dynamically
added to the SVC table by an authorized program after the system IPL. SVCMAP dumps
only the DEFAULT length of these routines since the length is unknown too.
Example
SVC 109 ESR(11) DISASM
Syntax
SVCMAP [number] [ESR(entry) ]
[DUMP ]
[DISASM ]
[CHANGE ]
[DEFAULT(size) ]
[MAXLEN(size) ]
Aliases
SV, SVC, SVCM, SVCMA, SVCMAP
Defaults
DEFAULT(256)
Required
none
Operands
number Optional. The SVC to be investigated. If no number is specified,
all 256 SVCs are listed.
ESR(entry) The ESR entry number to be investigated. If this operand is left
off on an ESR SVC, all ESR entries for the SVC are listed. This
operand only has meaning on an ESR SVC.
DUMP Dump the SVC module. If the module cannot be located in the
nucleus, LPA or MLPA (probably dynamically loaded), only the
DEFAULT length of the module is to be dumped.
The dump begins at the offset of the module indicated by the
address from the SVCTABLE entry. The length is calculated to be
the rest of the module regardless of other entry points.
The format of the dump is 6 or 8 bytes of storage address, 6
bytes of hexadecimal offset into the module, followed by 16
hexadecimal bytes of the module at that offset, and the
character equivalent surrounded by asterisks.
DISASM Disassemble the SVC module. If the module cannot be located in
the nucleus, LPA or MLPA (probably dynamically loaded), only
the DEFAULT length of the module is to be formatted.
The display begins at the offset of the module indicated by the
address from the SVCTABLE entry. The length is calculated to be
the rest of the module regardless of other entry points.
The format of the display is 6 or 8 bytes of storage address, 6
bytes of hexadecimal offset into the module, followed by the
operation code, reconstructed operands, the hexadecimal bytes
of the module at that offset, and the character equivalent
surrounded by asterisks.
CHANGE Invoke the FINDMOD routine to locate the SVC module in the
nucleus, LINKLIST or LPALIB concatenation and if found,
CHANGE to that data set.
DEFAULT(Sz) Format the length with DUMP or DISASM for a module that is not
found in the in-storage nucleus, LPA or MLPA. Code Sz as a
number between 8 and 99999.
MAXLEN(Mx) The maximum length to format with DUMP or DISASM. Code Mx
as a number between 8 and 99999.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
-------------------------- ISPMODE Session# 1 Log# 1 ROW 576 TO 593 OF 1,076
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.LIB.CLIST,VOL=SER=SER002 MEM=AD:LOG ----------------------------
>----->svc 109 esr(7) disasm
PDS093I ADDRESS MODULE LENGTH TYPE APF ESR NP AS AR LOCKS AMODE DESCRIPTION
ESR(7) 00DA5000 IGX00007 002A18 3/4 APF 31
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
-------------------------- ISPMODE Session# 2 Log ROW 1,000 TO 1,025 OF 1,257
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.PDSE311.PANELS,VOL=SER=SER006 MEM=PDSZ* ------------------------
>----->svcmap
PDS093I ADDRESS MODULE LENGTH TYPE APF ESR NP AS AR LOCKS AMODE DESCRIPTION
SVC 0 00FEE898 IECVEXCP 001EB8 1 L 24 EXCP
SVC 1 00FE22E6 IEAVEWAT 000F20 1 L 31 WAIT
SVC 2 00FF4BA0 IEAVEPST 002954 1 L 31 POST
SVC 3 01076388 IGC003 000D28 1 AR L 31 EXIT
SVC 4 011C9222 IGVVSM24 001218 1 L 31 GETMAIN
SVC 5 011C9222 IGVVSM24 001218 1 L 31 FREEMAIN
SVC 6 011EB198 CSVLINK 0001E0 2 L 31 LINK
SVC 7 011EBF60 CSVXCTL 000408 2 L 31 XCTL
SVC 8 011EB378 CSVLOAD 000188 2 L 31 LOAD
SVC 9 011EB070 CSVDELET 000128 2 L 31 DELETE
SVC 10 011C9E52 IGVVSM24 001218 1 L 31 FREEMAIN
SVC 11 0280BC48 IGC0001A 0003B8 3/4 31 TIME
SVC 12 011A95C8 CSVSYNCH 000598 2 AR L 31 SYNCH
SVC 13 0221F000 IGC0101C 015830 3/4 AS AR L 31 ABEND
SVC 14 01FD4020 IEAVTESP 001BE0 3/4 L 31 SPIE
SVC 15 0101D91A IECVPST 001C4C 1 L 31 ERREXCP
SVC 16 010F3140 IOSPURGA 001768 2 31 PURGE
SVC 17 02A49000 IGC0001G 0001C8 3/4 31 RESTORE
SVC 18 00B87818 ??? 000000 2 31 BLDL
SVC 19 00E02138 IGC0001I 00DC20 3/4 24 OPEN
SVC 20 00B8C660 ??? 000000 3/4 24 CLOSE
TSO Subcommand
Use the TSO subcommand to invoke a TSO command processor or CLIST. Specify any
operands after the name specified.
Example
TSO listc lev(sys2)
Syntax
TSO command [operands]
Aliases
T, TS, TSO
Defaults
none
Required
command
Operands
command CLIST or command processor to invoke. If you use the form %cnam,
CNAM is assumed to be a CLIST name.
operands Optional. Can include any operand.
Remarks
Use the TSO subcommand to invoke a TSO command processor or CLIST. Specify any
operand after the name specified.
This is the ISPF TSO command, if you enter TSO, when in ISPMODE or MEMLIST. To use
the StarTool FDM TSO subcommand, enter an alias subcommand name such as T or TS.
Your installation may have installed the TSO subcommand to obtain the equivalent of
“TSO TSOEXEC command operands”. If this is the case, invoke authorized commands with
fewer keystrokes. To determine if your installation has this option enabled, type a
CONTROL DEFAULT subcommand and look for an output line beginning “TSO calls”. A
value of TSOEXEC indicates it is enabled.
TSOEDIT Subcommand
The TSOEDIT subcommand edits a member; the TSO EDIT command is used.
Example
TSOEDIT mema:memb cntl
Syntax
TSOEDIT memgroup [ASIS ]
[OLD/NEW ]
[NONUM ]
[ASM/BASIC/CLIST/CNTL/COBOL/DATA/
FORTE/FORTG/FORTGI/FORTH/GOFORT/
IPLI/LIST/PLI/PLIF/TEXT/VSBASIC ]
Aliases
TSOE, TSOED, TSOEDI, TSOEDIT
Defaults
memgroup, EDIT type based on the data set name
Required
none
Operands
memgroup Identifies the members to be edited.
Default member names, member lists, member name ranges, and
member name patterns are allowed. For more information, see
Appendix A, "Formatting Member Names".
ASIS Edits the member with upper- and lower-case characters.
OLD Verifies that the member exists before calling EDIT.
NEW Verifies that the member does not exist before calling EDIT.
NONUM Edits the member without using line numbers.
ASM EDIT type is assembly.
BASIC EDIT type is BASIC.
CLIST EDIT type is CLIST.
CNTL EDIT type is CNTL.
COBOL EDIT type is COBOL.
DATA EDIT type is DATA.
FORTE EDIT type is FORTRAN level E.
FORTG EDIT type is FORTRAN level G.
FORTGI EDIT type is FORTRAN level GI.
FORTH EDIT type is FORTRAN level H
GOFORT EDIT type is GOFORT.
IPLI EDIT type is IPLI.
LIST EDIT type is LIST.
PLI EDIT type is PLI.
PLIF EDIT type is PLI (F-level).
TEXT EDIT type is TEXT.
VSBASIC EDIT type is VSBASIC.
Remarks
If you enter an EDIT type keyword, that keyword is passed to EDIT as the descriptive
qualifier; otherwise, a descriptive qualifier is chosen as follows:
1 If the low-level qualifier of the partitioned data set name is one of the valid descriptive
qualifiers for EDIT (ASM, BASIC, CLIST, CNTL, COBOL, DATA, IPLI, LIST, PLI, TEXT, or
VSBASIC), that qualifier is passed to EDIT.
2 If the low-level qualifier is FORT, GOFORT is passed to EDIT. Otherwise, the data type
qualifier is not a valid descriptive qualifier and the general descriptive qualifier, DATA,
is passed to EDIT.
This interface is optional. Use it only as an interface to the TSO EDIT command. To
terminate this interface, type END from the EDIT prompt.
TSOLIST Subcommand
The TSOLIST subcommand lists a member. The TSO LIST command is used. Specify any
LIST operand after the member name.
Remarks
This interface is optional. Use it only if your installation installed the public domain LIST
command.
Example
TSOLIST mema:memb
Syntax
TSOLIST memgroup [BYPASS(numtoskip) ]
[COL(begincol:endcol) ]
[HEX/X ]
[MAX(maxtolist) ]
[NUM/SNUM/NONUM ]
Aliases
TSOL, TSOLI, TSOLIS, TSOLIST
Defaults
memgroup, NUM (if a non-numeric is encountered, then NONUM)
Required
none
Operands
memgroup Identifies the members to be listed.
Default member names, member lists, member name ranges, and
member name patterns are allowed. For more information, see
Appendix A, "Formatting Member Names".
USAGE Subcommand
The USAGE subcommand displays statistics on the current data set. The DSNAME
subcommand is issued automatically with this subcommand.
Example
USAGE
Syntax
USAGE [ALL]
Aliases
U, US, USA, USAG, USAGE
Defaults
none
Required
none
Operands
ALL Displays data set extent information and formats the DSCB fields. Any
operand on the USAGE subcommand is sufficient to get all of the available
data.
Remarks
The statistics displayed include:
The number of disk storage tracks allocated the number of disk storage tracks
currently in use and free
The number of disk storage extents required for the data set
The number of directory blocks allocated
The number of directory blocks currently in use and free
The number of disk storage tracks used by the directory
The number of members in the directory
The number of member names that are alias names
The USAGE command displays statistics for up to 59 volumes. Up to nine volumes are
listed in the first panel. If more volumes are allocated, the volume list shows a plus (+)
character after the eighth volume on the first panel.
Following are some sample screens of the USAGE subcommand. USAGE with no operand
returns data from the first screen and the remaining screens are added for any operand
after USAGE.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------------------------------------------------------------
--------------------------- ISPMODE Session Display ---------- ROW 389 OF 452
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.LINK.LOAD,VOL=SER=STR804 MEM=LOADMEM -------------------------
>----->u all
PDS200I DISP UNIT RECFM LRECL BLKSIZE ALLOCTRK FREETRK SECONDARY FREEDIR
PDS200I SHR 3380 U 0 32760 2X 352 80 80 TRK 26
PDS180I Data set: CREATED EXPIRES LAST USE UPDATED LASTUSE FIRSTUSE
PDS180I 89/02/17 0/00/00 95/06/19 95/06/19 C911407 C911401T
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
--------------------------- ISPMODE Session Display ---------- ROW 421 OF 452
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.LINK.LOAD,VOL=SER=STR804 MEM=LOADMEM -------------------------
PDS184I EXTENT UCB LO TT-HI TT TRACKS LOW CCHH-HIGH CCHH BOUNDARY
PDS184I ------ --- ----- ----- ------ ----------- ----------- --------
PDS184I 0 46F 00.00 01.0F 272 02.F2.00.03 03.04.00.04 TRK
PDS184I 1 46F 01.10 01.5F 80 03.68.00.08 03.6D.00.0C TRK
PDS185I 48 4C 50 54 58 5C 60 64 68 6C 70 74 78 7C 80 84 88
PDS185I CFFFF50A000800C07F050008800500024F0000F0000000006000600000000000000000
PDS185I 3911490A000F2001F800000200001FA301010220334041138083D0C000000000000000
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
--------------------------- ISPMODE Session Display ---------- ROW 421 OF 452
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.LINK.LOAD,VOL=SER=STR804 MEM=LOADMEM -------------------------
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
--------------------------- ISPMODE Session Display ---------- ROW 438 OF 452
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.LINK.LOAD,VOL=SER=STR804 MEM=LOADMEM -------------------------
PDS186I 55 DS1OPTCD 01 OPTION CODE
PDS186I 56 DS1BLKL 32,760. BLOCK LENGTH
PDS186I 58 DS1LRECL 80. LOGICAL RECORD LENGTH
PDS186I 5A DS1KEYL 0. KEY LENGTH
PDS186I 5B DS1RKP 0. RELATIVE KEY POSITION
PDS186I 5D DS1DSIND 82 DATA SET INDICATORS
PDS186I 5E DS1SCALO 80000050 SECONDARY ALLOCATION
PDS186I 62 DS1LSTAR 010F0A TTR OF LAST USED TRACK AND BLOCK ON TRACK
PDS186I 65 DS1TRBAL 9,024. BYTES REMAINING ON LAST TRACK USED
PDS186I 67 F100 RESERVED (TWO BYTES)
PDS186I 69 DS1EXT1 0100.02F20003.03040004 FIRST EXTENT DESCRIPTION
PDS186I 73 DS1EXT2 0101.03680008.036D000C SECOND EXTENT DESCRIPTION
PDS186I 7D DS1EXT3 0000.00000000.00000000 THIRD EXTENT DESCRIPTION
PDS186I 87 DS1PTRDS 0000000000 CCHHR OF ANY ASSOCIATED FORMAT 2 OR 3 DSCB
VERIFY Subcommand
The VERIFY subcommand validity checks data sets. For PDS or PDSE data sets, check the
entire data set by entering a : in the member name position. Check an individual member
or member group by entering its name in the member name position.
Example
VERIFY mema:memb
Syntax
VERIFY memgroup
[LOAD/NOLOAD ]
[LKED/NOLKED ]
[MAXBLK(bsize) ]
[NAME/NONAME ]
[COUNT/NOCOUNT ]
[READ/NOREAD/INPUT/NOINPUT]
[STATS/NOSTATS ]
[UPDATE/NOUPDATE ]
[MEMBERS / MEMLIST / ML / NEWML / SUBLIST ]
* [FROMKEY(key)/FROMADDRESS(add)/FROMNUMBER(num) ]
* [TOKEY(key)/TOADDRESS(add)/TONUMBER(num) ]
* [EXAMINE / NOEXAMINE / NOINDEXTEST / NODATATEST ]
Aliases
V, VE, VER, VERI, VERIF, VERIFY
Abbreviations
FKEY for FROMKEY, FADDR for FROMADDRESS, FNUM for FROMNUMBER, TKEY for TOKEY,
TADDR for TOADDRESS, and TNUM for TONUMBER.
Defaults
memgroup, LOAD, LKED, NAME, READ, STATS, NOUPDATE, EXAMINE
Required
none
Operands
memgroup Identifies the members to be validity checked. If a : is entered
in the member name position, the data set is validity checked;
otherwise, only the specified members are checked individually.
Default member names, member lists, member name ranges,
and member name patterns are allowed. For more information,
see Appendix A, "Formatting Member Names" on page 417.
LOAD For load libraries, LOAD each member.
NOLOAD Does not LOAD any members.
LKED For load libraries, checks linkage editor attributes and LINKLIST
LLA member status.
NOLKED Does not perform any linkage editor checks or LINKLIST LLA
member status.
MAXBLK(bsize) Generates messages for members with blocks larger than the
value bsize.
NAME Checks member names for validity. Valid member names are
from 1 to 8 characters long containing upper-case alphanumeric
characters; the first character cannot be numeric.
NONAME Does not check member names for validity.
COUNT Outputs a short message giving input counts.
NOCOUNT Outputs normal messages.
READ Inputs each member (or the data set).
NOREAD Does not input any data.
INPUT Inputs each member (or the data set).
NOINPUT Does not read any data.
STATS Displays normal completion statistical messages.
NOSTATS Does not display statistical messages. This checks a member or
a data set for unusual conditions.
UPDATE Tests member addition and deletion to determine if the PDS
directory has any available space and if normal PDS operations
are possible on the data set. For a VSAM data set, performs an
IDCAMS VERIFY function.
NOUPDATE Does not update the data set.
MEMBERS Displays the names of members with warning or error messages
but without changing the current member group.
MEMLIST Same as ML. Any member with warning or error messages is
selected for MEMLIST display. These messages are in the range
PDS400W through PDS999E. If no members are selected, a null
sublist is the result.
ML Same as MEMLIST. Any member with warning or error
messages is selected for MEMLIST display. These messages are
in the range PDS400W through PDS999E. If no members are
selected, a null sublist is the result.
NEWML Same as MEMLIST and ML except that the current MEMLIST is
reset.
Remarks
The VERIFY subcommand validity checks PDS or PDSE data sets in the following manner:
1 For VERIFY : UPDATE, a dummy member is added and deleted to determine if the
data set directory is full and if normal PDS functions are possible. This is the only
potential data set update performed by the VERIFY subcommand and it is not
performed on a PDSE data set.
2 The data set directory is read, member names are placed into a program table in TTR
sort order (member location order) and the following checks are performed:
If NAME is in effect, member names are checked for validity
If the data set is a LINKLIST library and LKED is in effect, the LLA status of members
is checked with a system BLDL
A message is issued if the LLA status of a member cannot be determined due to a
module in a TASKLIB library or a member in a higher LINKLIST library
A message is issued if a member directory entry and its LLA entry are not identical
(they are not synchronized)
A message is issued if a LINKLIST member is not known to LLA
If the data set is a load library and LKED is in effect, the following illegal editor
attribute combinations are checked:
Modules with RENT and NOREUS attributes
Modules with RMODEANY and AMODE24 or AMODEANY attributes
Modules with OVLY and RENT, REUS, REFR, SCTR, RMODEANY, AMODE31, AMODE64,
or AMODEANY attributes
Modules with TEST and NOEDIT attributes
Modules with REUS and SCTR attributes
If the data set is a load library and LOAD is in effect, each member is checked for
ABENDS during a LOAD operation
Each member is checked for current usage by an ISPF EDIT session
Member directory entries are checked for correct name order
Each member TTR address is checked against the end of the data set
4 If READ or INPUT is in effect, the directory and each member is read checking for:
Permanent I/O errors
Input block sizes exceeding the MAXBLK value (or the DCB BLKSIZE if MAXBLK is
omitted)
BLKSIZE divided by input LRECL not integral (RECFM=F)
Input LRECL exceeding maximum DCB LRECL (RECFM=V)
Input LRECL less than 4 bytes (RECFM=V)
Null members
Directory RLD/CONTROL counts that do not match the first RLD entry
The VERIFY subcommand validity checks sequential or VSAM data sets in the following
manner:
1 For VSAM data sets if NOUPDATE is not specified, an IDCAMS VERIFY is performed on
the data set.
3 For a KSDS or an Alternate index if NOREAD is not specified, the data set is also read
sequentially to determine if the index is synchronized with the data.
4 Sequential data sets are checked for current usage by an ISPF EDIT session.
>------>ch jcl.cntl
PDS200I DISP UNIT OPT RECFM LRECL BLKSIZE ALLOCTRK FREETRK SECONDARY FREEDIR
PDS200I SHR 3380 C FB 80 23440 1X 80 41 10 TRK 7
** VERIFY JOBC
PDS860E JOBC is an alias but no main member exists
** VERIFY FIX
PDS510W This is a null member
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
--------------------------- ISPMODE Session Display ------------ ROW 52 OF 70
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.SAM.LOAD,VOL=SER=STR807 MEM=(PDSWHO --------------------------
>----->verify (pdswho,pdspgm)
** VERIFY PDSWHO
PDS860E Member is an alias but no main member exists
PDS861E The alias directory entry notes the main entry name as SYSDSN
** VERIFY PDSPGM
PDS111I 162 physical blocks were input
PDS112I 6,000 characters in the largest physical block
PDS113I 2,768 characters per average physical block
FUNCTIONS CONTROL DSN CMDS DATA CMDS A-M DATA CMDS N-Z DEFAULT FEATURE
-------------------------- ISPMODE Session# 1 Log# 1 -- ROW 168 TO 186 OF 186
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.VSAM.CSI,VOL=SER=SER004 -----------------------------------------
>----->ver
VERIFY FILE(SYS00303)
>------>Verify INPUT
VMAP Function
Use the VMAP command as a line command in LISTV for a particular volume or as a
primary command to format all extents of a volume.
Example
VMAP sysres
Syntax
VMAP volser
Aliases
VM, VMA, VMAP
Defaults
none
Required
volser
Operands
volser Name of the online disk volume whose extents are to be mapped.
Remarks
VMAP constructs a full volume extent map (including all free space) in disk address
(CCHH) order. The primary view for this table shows the size of each extent and the
associated DSNAME.
The alternate (reached with a LEFT or RIGHT command) view of this function represents
many statistics on each data set. The SORT, F (find), and REMOVE commands are
available for data manipulation. In addition, use the LC line command to copy an entry for
a particular data set to the LISTC/LISTF table for additional processing.
The following primary commands are supported directly for the VMAP function. For
information on ISPMODE commands available in StarTool FDM, see "Common Commands"
on page 39.
RF[IND] Finds a string (repeat find) and positions the display start
location. PF keys 5 and 17 are normally set to RFIND.
RI[GHT] Rotates through alternate views of the VMAP table. PF keys 11
and 23 are normally set to RIGHT.
SO[RT] Sorts function tables into an alternate order. SORT with no
operands sorts the table in default order, while SORT with a field
name sorts the table in that order.
Syntax SORT [CCHH/SIZE/LENGTH/EXTENTS/ALLOC]
[ASCEND/DESCEND]
Block line commands are doubled letters that delimit a range of table entries for which the
same action is to be performed. The following block line commands are supported for the
VMAP function:
== = command. Repeats the previous line command for the range of lines.
*cm ERR- t=”Block line command,==”>
FUNCTIONS CTL A-M CTL N-Z LINE CMDS A-M LINE CMDS N-Z DEFAULTS FEATURE
------------------------------------------------------------------------------
-------------------------------- VMAP STG00C ----------- ROW 1 TO 17 OF 592
COMMAND ===> right SCROLL ===> CSR
Enter an ISPF command or a special control code:
----------------------------------------------------------------------------
CMD CCHH End CCHH EX# DATA/MSG ---------DATA SET NAME -------------------
00000001 0001000E 1 *----29 SYS1.VTOCIX.STG00C_________________________
00020000 0008000E 1 *---105 *** FORMAT 4 (VTOC) EXTENT ***_____________
00090000 000A000E 1 *----30 SYS1.VVDS.VSTG00C__________________________
000B0000 000B0000 2 *-----1 UCIS033.ISPF350.ISPPROF____________________
000B0001 000B0001 1 *-----1 WTESSNT.PRD.R921.DBI.SRC___________________
000B0002 000B0003 1 *-----2 WTESSNT.OPS.MIG.LETTER.AU940488____________
000B0004 000B0004 1 *-----1 WFDFA3NT.STAR.ALL__________________________
000B0005 000B0005 1 *-----1 WFD5001.SPFTEMP1.CNTL______________________
+----------------+ 006 1 *-----1 UCIMSAVT.GL9002.GWF05.INDEX________________
| TOTAL= 301 | 007 1 *-----1 *** FREE SPACE EXTENT ***__________________
| NVSAM= 275 | 008 1 *-----1 UCIMSAVT.DC9001.LKGB01.INDEX_______________
| ADDS = 592 | 009 1 *-----1 WFDFA7NT.WILSON.YR9293_____________________
| EXT = 478 | 00A 1 *-----1 ACWCS86.PS0080S____________________________
| SPACE= 44418 | 00B 1 *-----1 WTESSNT.PRD.R921.EXP.CNT___________________
| FREE = 20931 | 00C 1 *-----1 UCIH003.EOXMBMGR.BKLSHELF__________________
+----------------+ 00D 1 *-----1 UCIS003.TRANSMIT.LOG_______________________
000B000E 000B000E 1 *-----1 *** FREE SPACE EXTENT ***__________________
When a VMAP function is invoked, the message lines have the following meanings:
FUNCTIONS CTL A-M CTL N-Z LINE CMDS A-M LINE CMDS N-Z DEFAULTS FEATURE
-------------------------------- VMAP STG00C -------- ROW 114 TO 121 OF 587
COMMAND ===> exclude po not do SCROLL ===> CSR
Enter an ISPF command or a special control code:
----------------------------------------------------------------------------
CMD CCHH End CCHH EX# DATA/MSG ---------DATA SET NAME -------------------
TYPE LENGTH DO RECFM LRECL BLKSI --SIZE- --FREE- USED ALLOC -SEC- RND EXT
087C000D 087D0005 1 *-----8 *** FREE SPACE EXTENT ***__________________
FRE 8
087B0006 087C0000 1 *----10 *** FREE SPACE EXTENT ***__________________
FRE 10
02D10000 02D8000E 1 *---120 ACWCS04.CN7662.DATA________________________
CYL 120 ** FB 132 31680 120T 119T 0% CYL 8 YES 1
02C90000 02D0000E 1 *---120 ACWCS04.CN7760.DATA________________________
CYL 120 ** FB 132 31680 120T 119T 0% CYL 8 YES 1
015A0000 015A000E 1 *----15 ACWCS50.FNA970.MATRIX______________________
CYL 15 PS FB 80 6160 15T 13T 13% CYL 1 YES 1
088E0000 0968000E 1 *--3285 ACWCS50.OBB.T.EXDETAIL_____________________
CYL 3285 PS FB 388 23280 3645T 0T 100% CYL 50 YES 2
0BE10000 0BF8000E 2 *---360 ACWCS50.OBB.T.EXDETAIL_____________________
CYL 360 PS FB 388 23280 3645T 0T 100% CYL 50 YES 2
0A570007 0A57000A 1 *-----4 ACWCS86.ISPF350.ISPPROF____________________
TRK 4 PO FB 80 6160 4T 0T 100% TRK 5 NO 1
FUNCTIONS CTL A-M CTL N-Z LINE CMDS A-M LINE CMDS N-Z DEFAULTS FEATURE
------------------------------------------------------------------------------
-------------------------------- VMAP STG00C ------------ ROW 1 TO 8 OF 194
COMMAND ===> SCROLL ===> CSR
EXCLUDE PROCESSING DONE, ROWS DELETE = 393
----------------------------------------------------------------------------
CMD CCHH End CCHH EX# DATA/MSG ---------DATA SET NAME -------------------
TYPE LENGTH DO RECFM LRECL BLKSI --SIZE- --FREE- USED ALLOC -SEC- RND EXT
000B0000 000B0000 2 *-----1 UCIS033.ISPF350.ISPPROF____________________
TRK 1 PO FB 80 6160 4T 0T 100% TRK 1 NO 3
000B0001 000B0001 1 *-----1 WTESSNT.PRD.R921.DBI.SRC___________________
TRK 1 PO FB 80 6080 1T 0T 100% TRK 2 NO 1
000B000B 000B000B 1 *-----1 WTESSNT.PRD.R921.EXP.CNT___________________
TRK 1 PO FB 80 3040 1T 0T 100% TRK 5 NO 1
000C0002 000C0005 5 *-----4 UCIMSANT.GL9002.DATA_______________________
TRK 4 PO FB 80 3120 170T 1T 99% TRK 4 NO 8
000C0006 000C0007 1 *-----2 WTESSNT.PRD.R921.IDC.CNT___________________
TRK 2 PO FB 80 3040 2T 1T 50% TRK 2 NO 1
000D0006 000D0006 1 *-----1 WTESSNT.OPS.ITS941.UTILCRD_________________
TRK 1 PO FB 80 6080 1T 0T 100% TRK 14 NO 1
000D000B 000D000C 1 *-----2 UCIO010.ISPF350.ISPPROF____________________
TRK 2 PO FB 80 6160 2T 0T 100% TRK 1 NO 1
000E0002 000E0005 4 *-----4 UCIMSANT.GL9002.DATA_______________________
TRK 4 PO FB 80 3120 170T 1T 99% TRK 4 NO 8
FUNCTIONS CTL A-M CTL N-Z LINE CMDS A-M LINE CMDS N-Z DEFAULTS FEATURE
-------------------------------- VMAP STG00C ----------- ROW 1 TO 17 OF 592
COMMAND ===> SCROLL ===> CSR
Enter an ISPF command or a special control code:
----------------------------------------------------------------------------
CMD CCHH End CCHH EX# DATA/MSG ---------DATA SET NAME -------------------
03E50000 05D0000E 1 *--7380 UCIMSAVT.GAP.APFM105.DATA__________________
05D10000 0716000A 1 *--4886 UCIHHCNT.HRCE0D.CUSENTDB___________________
088E0000 0968000E 1 *--3285 ACWCS50.OBB.T.EXDETAIL_____________________
09EC0001 0A560001 1 *--1591 WTESSNT.PRD.Q941.APP.LOAD__________________
0C9F0000 0D02000E 1 *--1500 WFDFA1NT.TSO.JCL___________________________
02510000 02AE0000 1 *--1396 WTESSNT.OPS.MIG.ISPFLIB____________________
0C270002 0C6E0000 3 *--1064 WFDFA1NT.PDB.STAR.NOV94____________________
0AB40000 0AEC000E 1 *---855 UCIGORNR.OREX0S.ORSEMIMO.STEP0010__________
0A600000 0A960003 2 *---814 WFDFA1NT.PDB.STAR.NOV94____________________
01A70000 01DA000E 3 *---780 WTESSNT.OPS.MIG.ISPFLIB____________________
02E7000A 031B0003 1 *---774 WFDFA8NT.MM94206.MF9306.MF9304.BA9410______
0344000A 0375000E 1 *---740 *** FREE SPACE EXTENT ***__________________
09790000 09A80007 1 *---713 WTESSNT.PRD.R921.APP.LINK__________________
0C6E0001 0C9B000E 1 *---689 WFDFA7NT.CMIS94.HIST9410.CYCLEEND.PRODROLL_
01770000 01A3000E 2 *---675 WTESSNT.OPS.MIG.ISPFLIB____________________
0AED0000 0B0E000E 1 *---510 WFDFA8NT.MM94206.MF9409.MF9404.BA9410______
02070000 02260006 1 *---472 *** FREE SPACE EXTENT ***__________________
FUNCTIONS CTL A-M CTL N-Z LINE CMDS A-M LINE CMDS N-Z DEFAULTS FEATURE
------------------------------------------------------------------------------
PDSPN37 ------------------------ VMAP STG00C ----------- ROW 1 TO 17 OF 583
COMMAND ===> SCROLL ===> CSR
Enter an ISPF command or a special control code:
----------------------------------------------------------------------------
CMD CCHH End CCHH EX# DATA/MSG ---------DATA SET NAME -------------------
03E50000 05D0000E 1 *--7380 UCIMSAVT.GAP.APFM105.DATA__________________
075C0000 0774000E 2 *---375 UCIMSAVT.GAP.APFM105.DATA__________________
07750000 078D000E 3 *---375 UCIMSAVT.GAP.APFM105.DATA__________________
078E0000 07A6000E 4 *---375 UCIMSAVT.GAP.APFM105.DATA__________________
07A70000 07BF000E 5 *---375 UCIMSAVT.GAP.APFM105.DATA__________________
05D10000 0716000A 1 *--4886 UCIHHCNT.HRCE0D.CUSENTDB___________________
088E0000 0968000E 1 *--3285 ACWCS50.OBB.T.EXDETAIL_____________________
0BE10000 0BF8000E 2 *---360 ACWCS50.OBB.T.EXDETAIL_____________________
02510000 02AE0000 1 *--1396 WTESSNT.OPS.MIG.ISPFLIB____________________
01770000 01A3000E 2 *---675 WTESSNT.OPS.MIG.ISPFLIB____________________
01A70000 01DA000E 3 *---780 WTESSNT.OPS.MIG.ISPFLIB____________________
010E0008 011A000C 4 *---185 WTESSNT.OPS.MIG.ISPFLIB____________________
00A90003 00C7000C 1 *---460 WFDFA1NT.PDB.STAR.NOV94____________________
0A600000 0A960003 2 *---814 WFDFA1NT.PDB.STAR.NOV94____________________
0C270002 0C6E0000 3 *--1064 WFDFA1NT.PDB.STAR.NOV94____________________
09EC0001 0A560001 1 *--1591 WTESSNT.PRD.Q941.APP.LOAD__________________
0C9F0000 0D02000E 1 *--1500 WFDFA1NT.TSO.JCL___________________________
VPRINT Subcommand
The VPRINT (VTAM print) subcommand prints a hardcopy list of a member. Use the TSO
VPSPRINT or DSPRINT command (as generated during StarTool FDM installation). Add any
VPSPRINT/DSPRINT operand after the member name.
Example
VPRINT mema:memb r525
Syntax
VPRINT memgroup printer
[CLASS(c) ]
[COL(col1:col2, ...) ]
[COPIES(number) ]
[DDNAME(ddname) ]
[DIRECT(KEEP/DELETE) ]
[EJECT/NOEJECT ]
[FCB(fcbname) ]
[FOLD(width)/TRUNCATE(width) ]
[FORMS(formname) ]
[HOLD/NOHOLD ]
[LINES(linenum1:linenum2) ]
[NOEJMESS ]
[NOHEADER ]
[NUM(loc,length)/SNUM(loc,length)/NONUM ]
[PAGELEN(num) ]
[SINGLE/DOUBLE/CCHAR ]
[TERMINAL ]
[TMARGIN(num)/BMARGIN(num) ]
[TRACE ]
[WTR(wtrname) ]
Aliases
VP, VPR, VPRI, VPRIN, VPRINT
Defaults
CLASS(A), COPIES(1), NOEJECT, NOHOLD, NUM, SINGLE
Required
memgroup, printer
Operands
memgroup Identifies the members to be printed.
Default member names, member lists, member name ranges, and
member name patterns are allowed. For more information, see
Appendix A, "Formatting Member Names".
printer Identifies the VTAM printer to print this data set.
operands Optional. Can include any TSO VPSPRINT or DSPRINT operand.
Remarks
The VPRINT (VTAM print) subcommand prints a hardcopy list of a member.
Use the TSO VPSPRINT or DSPRINT command. This choice was made during StarTool FDM
installation. To determine which program is used, type a CONTROL DEFAULT subcommand
and look for an output line beginning “VPRINT calls”.
VSAM Subcommand
The VSAM subcommand invokes the VSAM Services panel.
Syntax
VSAM
Note: All input fields are cursor selectable for the given service.
Selecting the Data Set name will execute the VINFO service.
"I" option from 3.2 will also initialize the model as will
an INFO line command on a VSAM cluster in LISTC/LISTF
VTOC Subcommand
The VTOC subcommand displays selected data sets on a disk or set of disks. Each disk has
a volume table of contents (VTOC). This table is searched for data sets that meet the
specifications.
This interface is optional. Use it only if your installation installed the public domain VTOC
command.
Example
VTOC tso001 CONT(dsna)
Syntax
VTOC (volumelist) [LEVEL(dsnamestart) ]
[EXLEVEL(dsnamestart) ]
[CONTAINING(dsnamestring) ]
[ENDING(dsnameend) ]
[BREAK(breakchars) ]
[CAT ]
[TRK/CYL/KB/MB ]
[NOSORT/SORT(sortfields) ]
[NOPRINT/PRINT(printop (printitemlist)) ]
[LIMIT(keyword oper value) ]
[AND1/OR1(keyword oper value) ]
[AND2/OR2(keyword oper value) ]
[AND3/OR3(keyword oper value) ]
[CHARS(charsperline) ]
[LINES(linesperpage) ]
[NOHEADING/HEADING(text) ]
[DSNLEN(length) ]
Aliases
VT, VTO, VTOC
Defaults
List all data sets on the volumes selected; SORT, PRINT, TRK
Required
volumelist
Operands
volumelist A volume name or a list of volume names in parentheses. If you
enter the first 1 to 5 characters of a volume name, all volumes
that are mounted that start with those characters are listed. If
you specify ALL, all non-virtual volumes that are online and ready
are processed. If you specify ALV, all virtual volumes that are
online and ready are processed if they are mounted PRIVATE/
RESERVED or PRIVATE/RESIDENT.
LEVEL The high-level qualifiers to be searched. This is not prefixed by
(dsnstart) your user ID or prefix. Only data sets starting with these prefixes
are listed.
EXLEVEL The high-level qualifiers to be omitted. This is not prefixed by
(dsnstart) your user ID or prefix. Data sets starting with this prefix are not
listed.
CONTAINING A character string contained in the data set name. At least one of
(dsnstr) the strings must be in the DSNAME for the data set to be listed.
This string does not need to conform to DSNAME standards; it
can begin with a period or a number.
PRINT(ptop The items to print. Ptop is the print formatting option as follows:
(ptitems))
NEW - the ptitems is a complete list of what to print
REP - the first ptitem is replaced with the rest of the items on the
list
ADD - the rest of the ptitems are added after the first item on the
list
DEL - the ptitems named are not printed
The ptitems names are the same keywords used in LIMIT, AND,
and OR functions and are also the titles as printed. These
keywords can be ALLOC, UNUSED, USED, PCT, EX, DSO, RFM,
BLKSZ, LRECL, CDATE, EXPDT, REFDT, SECT, PASS, ROUND,
CCHH, VOLUME, UNIT, DSNAME, ACTION, TYPE, RACF, or UPD.
The ADD, DEL, and REP print operations refer to the default print
list. The default list is ALLOC, UNUSED, PCT, EX, DSO, RFM,
BLKSZ, LRECL, REFDT, CDATE, VOLUME, DSNAME, EXPDT, SECQ,
SECT, ROUND, PASS, ACTION, and type. As noted under CHARS
above, only the items that fit on the print line are listed.
LIMIT(key oper The data sets to be listed. Only data sets that satisfy the relation
value) are listed.
key can be ALLOC, UNUSED, USED, PCT, EX, DSO, RFM, BLKSZ,
LRECL, CDATE, EXPDT, REFDT, SECT, PASS, ROUND, CCHH,
VOLUME, UNIT, DSNAME, ACTION, TYPE, RACF, or UPD.
oper can be EQ, NE, LE, LT, GE, or GT.
value can be a comparison value such as FB, PS, R, or a number
like 51.
keyword The name of a data set field as follows. The keywords and their
values are the same as in the VTOC output.
ALLOC - data set allocation; number of kilobytes, tracks, cylinders,
or megabytes allocated. Default is in tracks
UNUSED - amount of unused space in the data set. Same units as
in ALLOC
USED - amount of space used in the data set. Same units as in
ALLOC
PCT - percentage of space used in the data used
EX - number of extents in the data set
DSO - data set organization
PS = sequential
PO = partitioned
VS = VSAM
PE = PDSE data
DA = direct
IS = ISAM
U = unmoveable
RFM - record format
F = fixed
V = variable
U = undefined
B = blocked
T = track overflow
S = spanned or standard
A = ASA carriage control
M = machine carriage control
BLKSZ - block size for physical blocks of data
LRECL - logical record length in bytes
CDATE - creation date in the form YYDDD, sometimes called Julian
EXPDT - expiration date in the same form. This field is rarely used
REFDT - last use date in the same form. This date is when the data
set was last opened
SECT - type of allocation
A = absolute track
B = blocks
T = tracks
C = cylinders
PASS - protection indicators
N = none
T = read and write protection
W = write protection
ROUND - space rounded up to cylinders
R = round
N = no round
CCHH - cylinder and head address, in 4 or 8 hexadecimal digits. If
4 digits are used, only the cylinder is used for comparison;
otherwise, the cylinder and track are compared
VOLUME - Volume serial number or disk name
UNIT - Unit or device type
DSNAME - Name of the data set
ACTION - Some error indications
TYPE - Reserved for exit usage
RACF - RACF indicator
N = not indicated
Y = indicated
UPD - updated since last backup
N = not updated
Y = updated
oper An operator. The list of operators is as follows:
EQ is equal to
NE is not equal to
LE is less than or equal to
LT is less than
GE is greater than or equal to
GT is greater than
value Gives the value of the item for comparison, such as FB, PS, R, or
a number.
AND1(key oper Data sets to be listed. Both LIMIT and this condition must be true
value) to allow the listing.
key can be ALLOC, UNUSED, USED, PCT, EX, DSO, RFM, BLKSZ,
LRECL, CDATE, EXPDT, REFDT, SECT, PASS, ROUND, CCHH,
VOLUME, UNIT, DSNAME, ACTION, TYPE, RACF, or UPD.
oper can be EQ, NE, LE, LT, GE, or GT.
value can be a comparison value such as FB, PS, R, or a number
like 51.
OR1(key oper Data sets to be listed. Either LIMIT and this condition must be
value) true to allow the listing.
key can be ALLOC, UNUSED, USED, PCT, EX, DSO, RFM, BLKSZ,
LRECL, CDATE, EXPDT, REFDT, SECT, PASS, ROUND, CCHH,
VOLUME, UNIT, DSNAME, ACTION, TYPE, RACF, or UPD.
oper can be EQ, NE, LE, LT, GE, or GT.
value can be a comparison value such as FB, PS, R, or a number
like 51.
AND2(key oper Data sets to be listed. Both the previous result and this condition
value) must be true to allow the listing.
key can be ALLOC, UNUSED, USED, PCT, EX, DSO, RFM, BLKSZ,
LRECL, CDATE, EXPDT, REFDT, SECT, PASS, ROUND, CCHH,
VOLUME, UNIT, DSNAME, ACTION, TYPE, RACF, or UPD.
oper can be EQ, NE, LE, LT, GE, or GT.
value can be a comparison value such as FB, PS, R, or a number
like 51.
OR2(key oper Data sets to be listed. Either the previous result or this condition
value) must be true to allow the listing.
key can be ALLOC, UNUSED, USED, PCT, EX, DSO, RFM, BLKSZ,
LRECL, CDATE, EXPDT, REFDT, SECT, PASS, ROUND, CCHH,
VOLUME, UNIT, DSNAME, ACTION, TYPE, RACF, or UPD.
oper can be EQ, NE, LE, LT, GE, or GT.
value can be a comparison value such as FB, PS, R, or a number
like 51.
AND3(key oper Data sets to be listed. Both the previous result and this condition
value) must be true to allow the listing.
key can be ALLOC, UNUSED, USED, PCT, EX, DSO, RFM, BLKSZ,
LRECL, CDATE, EXPDT, REFDT, SECT, PASS, ROUND, CCHH,
VOLUME, UNIT, DSNAME, ACTION, TYPE, RACF, or UPD.
oper can be EQ, NE, LE, LT, GE, or GT.
value can be a comparison value such as FB, PS, R, or a number
like 51.
OR3(key oper Data sets to be listed. Either the previous result or this condition
value) must be true to allow the listing.
key can be ALLOC, UNUSED, USED, PCT, EX, DSO, RFM, BLKSZ,
LRECL, CDATE, EXPDT, REFDT, SECT, PASS, ROUND, CCHH,
VOLUME, UNIT, DSNAME, ACTION, TYPE, RACF, or UPD.
oper can be EQ, NE, LE, LT, GE, or GT.
value can be a comparison value such as FB, PS, R, or a number
like 51.
Remarks
Following are some examples of uses for the VTOC command.
List all data sets on VOL*** volumes:
VTOC vol
List all data sets on all volumes:
VTOC all
List all data sets that start with XXX on any MV**** volume:
VTOC mv lev(xxx)
List all data sets that contain LIST and do not start with SYS1:
VTOC vol cont(list) exlev(sys1)
List all recently created data sets:
VTOC vol lim(cdate gt 93001)
List data sets with unused space:
VTOC vol lim(pct lt 50) or1(unused gt 30)
List data sets with multiple extents:
VTOC vol lim(ex gt 1)
List all of a user’s data sets on TSO001:
VTOC tso001 level(ser002)
List all data sets over 100 tracks:
VTOC vol lim(alloc gt 100)
List CLIST data sets:
VTOC vol end(clist)
List all of the information about a user’s data sets at a 3270:
VTOC vol char(150)
List data sets under the fixed heads:
VTOC vol lim(cc eq 0001) or1(cc eq 0002)
Check if data sets on volume VOL*** are cataloged correctly:
VTOC vol cat print(new (alloc pct cat dsname))
List used space instead of unused, in tracks:
VTOC vol print(rep (unused used)) trk
List all data sets on 335*** volumes sorted by ALLOC in descending sequence,
VOLUME and DSNAME in ascending sequence:
VTOC 335 sort(alloc,d,volume,a,dsname,a)
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
-------------------------- ISPMODE Session# 1 Log# 1 -- ROW 112 TO 128 OF 128
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.LIB.CNTL,VOL=SER=SER006 MEM=(BATDELAY --------------------------
>----->vtoc ser cont(ser07.lib.)
ALLOC UNUSED PCT EX DSO RFM LRECL BLKSZ CDATE REFDT VOLUME DSNAME
379 100 2 PO FB 80 13680 93064 93197 SER006 SER07.LIB.ASM
140 97 30 4 PO FB 80 9040 89277 93207 SER007 SER07.LIB.CLIST
4 2 50 3 PO VB 255 32760 91074 93206 SER006 SER07.LIB.CLISTV
100 15 85 1 PO FB 80 13680 93076 93207 SER006 SER07.LIB.CNTL
1 100 1 PO FB 80 9040 92199 93015 SER006 SER07.LIB.EXPDT
25 100 1 PO FB 80 9040 89277 93194 SER007 SER07.LIB.FILE11
63 100 1 PO FB 80 9040 89277 93204 SER007 SER07.LIB.FILE29
203 100 2 PO U 0 32000 89277 93195 SER007 SER07.LIB.LOAD
765 225 70 3 PO FB 80 13680 93126 93207 SER006 SER07.LIB.PDSE
459 100 1 PO FB 80 13680 93126 93204 SER006 SER07.LIB.PDSE31
180 100 2 PO FB 80 13680 93180 93181 SER006 SER07.LIB.PDSE32
4 100 1 PO FB 80 9040 92265 93176 SER007 SER07.LIB.PDSINS
2 100 1 PO U 0 13030 93190 93197 SER007 SER07.LIB.STOW
10 9 10 1 PS FB 200 2000 93181 93181 SER007 SER07.LIB.TESTVS
TOTALS - 14 DATA SETS, 2335 TRKS ALLOC, 1987 TRKS USED
******************************* BOTTOM OF DATA *******************************
VUSE Subcommand
The VUSE (volume usage) subcommand checks disk volume statistics and usage.
Example
VUSE sysres all
Syntax
VUSE volume [SHORT/LONG/ALL]
Aliases
VU, VUS, VUSE
Defaults
SHORT
Required
volume
Operands
SHORT Provides basic information for a volume including free space statistics
and the current volume usage.
ALL Includes SHORT information and formats any SMS VOLUME RECORD
information and the FORMAT 4 DSCB. Same as LONG.
LONG Includes SHORT information and formats any SMS VOLUME RECORD
information and the FORMAT 4 DSCB. Same as ALL.
Remarks
The VUSE subcommand is useful for determining the amount of free space on a volume as
it displays the largest five free extents in track and cylinder units. It is also useful for
diagnosing volume errors as the FORMAT 4 DSCB can be interpreted by this subcommand.
PDS087I Free space: 5560 TRACKS OR 23%; 112 EXTENTS INCLUDING 342 FULL CYLIN
PDS087I Free space: 5560 TRACKS or 23%; 112 EXTENTS INCLUDING 342 FULL CYLIN
PDS089I LARGEST EXTENTS: #1 #2 #3 #4 #5
PDS089I CYL.TRKS 49.05 31.07 30.12 25.11 17.08
PDS089I TRACKS 740 472 462 386 263
PDS185I 48 4C 50 54 58 5C 60 64 68 6C 70 74 78 7C 80 84 88
PDS185I ......................................................................
PDS185I 0200320000000000000000000000000000000000000000000000000000000000000000
PDS185I 00002D00000000000000000000000000000100200080E0000000000000000000000000
If a volume is SMS-controlled, the ALL or LONG operand also formats the following SMS
VOLUME RECORD information.
WHOHAS Subcommand
The WHOHAS subcommand displays users allocated to a data set.
Example
WHOHAS ‘sys1.uads’
Syntax
WHOHAS dataset / *
Aliases
WH, WHO, WHOH, WHOHA, WHOHAS
Defaults
none
Required
dataset
Operands
dataset Identifies the data set to be checked.
* Check the currently allocated data set.
Remarks
Use WHO (short for WHOHAS) as a line command in LISTA/DDNAME, LISTC/LISTF and
WORKPAD.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
------------------------------------------------------------------------------
-------------------------- ISPMODE Session# 1 Log ROW 1,000 TO 1,005 OF 1,005
COMMAND ===> SCROLL ===> CSR
- DSN=ISF.V1R3M2.ISFLPA,VOL=SER=SYSS1C MEM=IGX00011 ------------------------
>----->whohas 'sys1.uads'
PDS292I 'SYS1.UADS' is allocated as follows:
PDS292I JOBNAME SCOPE TYPE STATUS SYSTEM RESERVE
PDS292I DLE1 SYSTEM SHR USING SCU1 NO
PDS292I SSI003 SYSTEM SHR USING SCU2 NO
PDS292I SSI002 SYSTEM SHR USING SCU1 YES
PDS292I SER07 SYSTEM SHR USING SCU2 CONVERTED
******************************* BOTTOM OF DATA *******************************
WORKPAD Function
Use the WORKPAD command to store StarTool FDM subcommands, data set names, TSO
commands, CLISTS, and REXX execs in an ISPF table. Each individual table element can
be re-executed whenever you want.
WORKPAD tables are saved permanently. They are saved in the ISPF profile data set by
default (ISPPROF) but the DDNAME can be changed in the SETALL option. To manage
these tables, use the SAVE, ID, MERGE, NOSAVE and ERASE commands. To automatically
save these tables at program end or when a new WORKPAD table is retrieved, check the
setting of “Automatic save” in SETALL for WORKPAD.
Saved WORKPAD tables are given members names of the form PDSWP0na if the name is
one or two numeric digits; otherwise, use a name of the form @@name where name is a
1- to 6-character alphanumeric table identification name.
Example
WORKPAD
Syntax
WORKPAD [name] [ALTERNAT] [SETUP]
Aliases
W, WO, WOR, WORK, WORKP, WORKPA, WORKPAD
Defaults
0
Required
none
Operands
name 1- to 6-alphanumeric characters, the WORKPAD table name to
retrieve.
ALTERNAT Displays the alternate WORKPAD panel (for new WORKPADs only).
SETUP Execute each line of the WORKPAD in EXPRESS mode.
Remarks
The WORKPAD ISPF table displays in response to a WORKPAD command. When you are in
a WORKPAD display, you can delete a part of the table, find data in the table, insert
elements into the table, print a part of the table, store a part of the table in a data set,
and so on. For help with the different options available, use the HELP command, CUA
functions, or enter the O command as a primary command or as a line command.
WORKPAD is a versatile service to keep sets of commands and data set names for easy
reference. These sets are shared between groups and the installation. Sample table 99 is
supplied by SERENA and can be modified by your installation as an index to other
samples. Reserve table 0 for temporary use and table 1 for your own index. Use Table 2
for setup.
The SETUP operand on the WORKPAD command allows you to execute a series of StarTool
FDM commands without intervention. Any data set entries in this mode result in executing
a GO line command. Follow each data set entry by a MEMLIST command to build a
MEMLIST for each data set.
When you modify a WORKPAD table entry, it is not executed automatically. You can
change this default for the current session by typing MODE EXEC.
OPT Option. Specifies the program action (the line command field).
MSG/RC Message or return code. Displays program feedback messages.
TYPE Command type. Specifies the type of entry.
* is a comment entry
- is a TSO command, a CLIST, or a REXX exec
D is a data set name
P is a StarTool FDM subcommand
T is a TSO command whose output is to be TRAPPED in the log
PDS/TSO Command field. This is where the data set name, command, or
subcommand is entered and displayed. Comments can be added after
any entry. Type /* and follow it with any data.
The alternate WORKPAD table contains additional entry fields for data sets. Enter the
volume name and a member group specification with up to 17 characters. The BB block
line command and the BR, ED, and ML line commands use the MEMBERS field from the
alternate WORKPAD table.
The following primary commands are supported for the WORKPAD function. For
information on ISPMODE commands available in StarTool FDM, see "Common Commands"
on page 39.
ADD Adds 5 blank table lines to the end of the WORKPAD table.
ALT[ERNAT] Displays an alternate view of the WORKPAD table.
APP[LY] Applies the specified line command to all table entries and executes
each entry.
Syntax APPLY linecmd
COMPR[ESS] Global command. Changes to each data set in the table and issues
a COMPRESS subcommand.
Syntax COMPRESS [LIST/NOLIST/SUMMARY]
DUA[L] Displays a double line view of the WORKPAD table.
EDITT[BL] Enters an edit session on WORKPAD table data.
(or ET[BL])
ER[ASE] Deletes the WORKPAD table in memory and on disk.
EXPR[ESS] Executes all entered line commands without pauses between
individual commands.
F Finds a string and positions the display start location.
Syntax
F anystring [ASIS]
[FIRST/LAST/PREV] [PREFIX/SUFFIX/WORD]
[ANY/COMMAND]
FI[ND] Global command. Changes to each data set in the table and issues
a FIND subcommand. Since the syntax entered on a FIND
subcommand is applied to each data set individually, do not
attempt to search mixed partitioned and non-partitioned data sets
with a single FIND global command.
Syntax
FIND memgroup 'anystring'
[NUM/SNUM/NONUM/LBLOCK/LDUMP/BLOCK/DUMP]
[CAPS/ASIS/IGNORE] [WORD/PREFIX/SUFFIX]
GL[OBAL] Global command. Changes to each data set in the table and issues
any StarTool FDM subcommand.
Syntax GLOBAL anysubcommand [anyoperands]
MER[GE] Merges data from a different table into the current table.
Syntax MERGE name [GROUP/SAMPLE] [RESET]
[TOP/BOTTOM/HERE]
MODEL Global command. Changes to each data set in the table and issues
a MODEL command.
NOR[MAL] Displays the default view of the WORKPAD table.
NOS[AVE] Do not save the current WORKPAD on disk regardless of the setting
of “Automatic save” in SETALL for WORKPAD.
O[PTIONS] Provides primary command selection for the WORKPAD function
and operand syntax assistance.
OUT[PUT] Outputs the WORKPAD table to print or a data set.
Syntax OUTPUT [=c / F(ddname)]
REPL[ACE] Global command. Changes to each data set in the table and issues
a REPLACE subcommand. Since the syntax entered on a REPLACE
subcommand is applied to each data set individually, do not
attempt to update mixed partitioned and non-partitioned data sets
with a single REPLACE global command.
Syntax
REPLACE memgroup 'fromstring' 'tostring'
[NUM/SNUM/NONUM/LBLOCK/LDUMP/BLOCK/DUMP]
[CAPS/ASIS/IGNORE] [WORD/PREFIX/SUFFIX]
[WRITE/NOWRITE]
RESET Often used with data set tagging, clears the DATA/MSG field in all
table entries.
RF[IND] Finds a string (repeat find) and positions the display start location.
PF keys 5 and 17 are normally set to RFIND.
RI[GHT] Rotates through alternate views of the WORKPAD table. PF keys 11
and 23 are normally set to RIGHT.
SAM[PLE] Merges table number 99 from the installation table library (usually
ISPTLIB) into the current WORKPAD table. Table 99 is an index to
other sample WORKPAD tables. The additional sample tables can
be included by using the MERGE command.
SAVE Creates a permanent table for use in a later StarTool FDM session.
Syntax SAVE [name] [REPLACE/NOREPL]
SO[RT] Sorts the WORKPAD table into order based on the WORKPAD
entries.
Syntax SORT
TAG Applies the specified line command to table entries marked with
*TAG* in the DATA/MSG field and executes each entry.
Syntax TAG linecmd
The following line commands are supported in the WORKPAD function. The DFHSM
commands are supported from the UT panel and BR, ED and ML refer to a MEMBERS
column displayed on an alternate panel that can be reached with PF10 or PF11.
Block line commands are doubled letters that delimit a range of table entries for which the
same action is to be performed. The following block line commands are supported in the
WORKPAD function:
== = command. Repeats the previous line command for the range of lines.
*cm ERR- t=”Block line command,==”>
FUNCTIONS CTL A-M CTL N-Z LINE CMDS A-M LINE CMDS N-Z DEFAULTS FEATURE
-------------------------- StarTool Workpad Table 0 --------- ROW 1 TO 4 OF 4
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.LIB.CNTL,VOL=SER=SER005 MEM=/ASM -------------------------------
OPT MSG/RC TYPE ------ PDS/TSO COMMAND or CLIST ----------------------------
---- -------- - ------------------------------------------------------------
* This whole entry is a comment.
FUNCTIONS CTL A-M CTL N-Z LINE CMDS A-M LINE CMDS N-Z DEFAULTS FEATURE
-------------------------- StarTool Workpad Table 15 -------- ROW 1 TO 4 OF 4
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.LIB.CNTL,VOL=SER=SER005 MEM=/ASM -------------------------------
OPT MSG/RC TYP MEMBER VOLUME ------- DSNAME/PDS/TSO COMMAND or CLIST ------
D 'SER07.SMSTEST.DATA06'
ut *ML* D @:ABC MVSD4B 'SER07.SMSTEST.DATAPDS'
D MIGRAT 'SER07.PDS110.DOC'
*EXEC* P list pds99t1e /* this is a comment
XREF Subcommand
The XREF subcommand lists internal symbol cross references in a load module. It is
similar to the output produced by the XREF option of the linkage editor except that
references are provided by actual name used and sorted by name or by location.
Example
XREF mema:memb
Syntax
XREF memgroup [MODULE({* / Fullm / Partm*)} ]
[ENTRY(Entname) ]
[SHORT ]
[SORT/NOSORT ]
[NOSTACK ]
Aliases
XR, XRE, XREF
Defaults
memgroup, SORT
Required
none
Operands
memgroup Identifies the load members for which you want cross reference
information.
Default member names, member lists, member name ranges, and
member name patterns are allowed. For more information, see
Appendix A, "Formatting Member Names" on page 417.
MODULE A1- to 8-byte partial external name that limits CSECT and ENTRY
(name) names for XREF reporting.
The MODULE operand has several valid forms:
MODULE(*) - uses the previous name entered on any MODULE
keyword
MODULE(Fullm) - reports only on CSECT or ENTRY FULLM
MODULE(Partm*) - reports only on CSECT or ENTRY PARTM...
ENTRY A 1- to 8-byte partial entry name used to limit XREF output similar to
(Entname) the MODULE keyword.
SHORT Displays only the callers of a CSECT or ENTRY point name.
SORT Output CSECT names in order of CSECT name.
NOSORT Output CSECT names in order of address or CSECT location.
NOSTACK Outputs a single data value on an output line for use with programs
that post-process XREF outputs.
Remarks
The XREF subcommand lists internal symbol cross references in a load module.
In the following example, the PDS441W message documents a missing weak external
reference. The missing CSECT (VTSOCMD) is referenced from PDSMAIN and PDSPCOMM.
Also, on the PDS168I message, the CSECT name and any ENTRY name referenced is
noted with a special syntax. In this example, PDSMAIN has at least one reference to
ENTRY PDS$CHA in CSECT PDSOPTIO. This information is represented by
PDSOPTIO<PDS$CHA> in the second line of the first PDS168I message.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
--------------------------- ISPMODE Session Display ---------- ROW 563 OF 726
COMMAND ===> SCROLL ===> CSR
- DSN=C911407.SAM.LOAD,VOL=SER=STR807 MEM=PDSE -----------------------------
>----->xref pdse nosort
** XREF PDSE
PDS441W PDS#SECI (Weak)
PDS441W VTSOCMD (Weak)
PDS166I PDS#SECI From: PDSMAIN
PDS166I VTSOCMD From: PDSMAIN, PDSPCOMM
PDS166I PDSMAIN From: PDSSTAEX, PDSAPPL, PDSOPTIO, PDSIDSPY, PDSPCOMM
PDS168I PDSMAIN To: PDS#SECI, VTSOCMD, PDSPDSIN, PDSATTNX, PDSSTAEX, PDSPARSE,
PDSIDSPY, PDSALLOC, PDSEXCP, PDSCLEAR, PDSPCOMM, PDSOPTIO<PDS$CHA>,
PDSDSNAM, PDSEXEC, PDSOPTIO<PDS$TBL>, PDSOPTIO, PDSDISPL,
PDSLIST<PDSREPLA>, PDSLIST<PDSLISTX>, PDSMSGS
PDS166I PDSPDSIN From: PDSMAIN
PDS166I PDSATTNX From: PDSMAIN
PDS166I PDSSTAEX From: PDSMAIN, PDSPCOMM, PDSIDSPY
PDS168I PDSSTAEX To: PDSMAIN, PDSALIAS, PDSPARSE, PDSIDSPY
PDS166I PDSALLOC From: PDSMAIN, PDSPCOMM
ZAP Function
The ZAP command modifies load modules. Make these modifications by typing over
hexadecimal or character data. ZAP is a line command supported by the CSECTS
command.
Example
zap
Syntax
zap
Aliases
z, za, zap
Defaults
none
Required
none
Operands
none
Remarks
The CSECTS ISPF table displays in response to a CSECTS command. The ZAP line
command invokes the ZAP command processor for a given CSECT in a load module. When
you are in a ZAP display you can delete a part of the table, find data in the table, print a
part of the table, or store a part of the table in a data set. For help with the different
options available, use the HELP command, CUA functions, or enter an O command as a
primary command or as a line command.
To make modifications to the ZAP table, type over the character or hexadecimal data.
After you make all changes to a CSECT, enter ZAP as a primary command to update your
on disk. Each ZAP data line has the following fields:
The following primary commands are supported for the ZAP function. For information on
ISPMODE commands available in StarTool FDM, see “Common Commands” in Appendix 2,
"ISPF Interface Commands".
APP[LY] Applies the specified line command to all table entries and executes
each entry.
Syntax APPLY linecmd
BA[SE] Resets the base address for this CSECT (like an AMASPZAP BASE
statement).
Syntax BASE hexaddress
(1 to 6 hexadecimal digits)
BU[ILD] Outputs AMASPZAP format output without changing the data set.
AMASPZAP backout controls are also formatted as comments.
EDITT[BL] Enters an edit session on ZAP table data.
(or ET[BL])
EXPR[ESS] Executes all entered line commands without pauses between
individual commands.
F Finds a string and positions the display start location.
Syntax
F hexstring/'anystring' [ASIS/CHAR]
[FIRST/LAST/PREV] [PREFIX/SUFFIX/WORD]
[HALFWORD/FULLWORD]
NOZ[AP] Exits the ZAP function without changing any additional data on disk.
OFF[SET] Resets the beginning offset for CSECT displays. Lower offsets are not
displayed.
Syntax OFFSET hexaddress
(1 to 6 hexadecimal digits)
O[PTIONS] Provides primary command selection for the ZAP function and
operand syntax assistance.
OUT[PUT] Outputs the ZAP table to print or a data set.
Syntax OUTPUT [=c / F(ddname)]
RF[IND] Finds a string (repeat find) and positions the display start location. PF
keys 5 and 17 are normally set to RFIND.
TAG Applies the specified line command to table entries marked with
*TAG* in the DATA/MSG field and executes each entry.
Syntax TAG linecmd
DIS Disassembles a few lines starting at the current offset. Follow DI or DIS by
an even number in the range of 2 through 14 to designate at what decimal
offset the disassembly is to begin. For example, DI10.
K Kills and clears all following line commands.
LOG Copies the line into the log.
M Provides line command selection and entry assistance.
O Provides line command selection and operand syntax assistance.
TAG Marks this table entry with *TAG* in the DATA/MSG field.
UNDO Changes this data back to its original value. This does not restore data from
before a ZAP primary command.
X Drops the table line.
Block line commands are doubled letters that delimit a range of table entries for which the
same action is to be performed. The following block line commands are supported in the
ZAP function:
== = command. Repeats the previous line command for the range of lines.
LL LOG command. Copies the range of lines into the log.
OO O command. Provides line command assistance for each line.
XX X command. Drops the range of table lines.
FUNCTIONS CONTROL DSN CMDS MEM CMDS A-M MEM CMDS N-Z DEFAULTS FEATURES
-------------------------- ISPMODE Session# 2 Log ROW 1,008 TO 1,015 OF 1,015
COMMAND ===> SCROLL ===> CSR
- DSN=SER07.LINK.LOAD,VOL=SER=SER007 MEM=DSA* ------------------------------
NAME DSAT DSAT NAME DSAT DSAT
VER 0004D4 000A47F0 VER 0004D4 000A4780
REP 0004D4 000A4780 REP 0004D4 000A47F0
VER 0004D8 C3B649F0 VER 0004D8 C23249F0
REP 0004D8 C23249F0 REP 0004D8 C3B649F0
VER 0004E4 D472C578 VER 0004E4 D472C57C
REP 0004E4 D472C57C REP 0004E4 D472C578
IDRDATA BUILDTST IDRDATA BUILDTST
******************************* BOTTOM OF DATA *******************************
StarTool FDM allows many different member name forms. Type member names in
character or hexadecimal mode for any subcommand that processes member names.
Character member names can be from 1 to 8 bytes long with no imbedded blanks,
commas, parentheses, colons, slashes, asterisks, question marks, or percent symbols.
Hexadecimal member names can contain from 1 to 16 hexadecimal digits delimited by x'
and '. X'd7c4e2c5'. PDSE are entirely equivalent; also, x'333' and x'0333' are equivalent.
A member name range, member name pattern, or member name combination form what
is termed a member group. A simple member name, a pattern, or a combination name
can contain ? or % characters as placeholders. You can also use a member list (that is, a
parenthesized list containing member and member group specifications separated by
commas).
When a member group is being processed, the subcommand processing routine is re-
executed for each member in the group. Specifically, note the following:
Member name Any of these subcommands can select all members whose names
pattern contain pattern characters by specifying a member name
segment, a slash, and another member name segment (either,
but not both, of the member name segments can be null).
Logic from the PATTERN subcommand selects members. The
subcommand processes these selected members in alphabetic
order. The following specifications select the same member
names:
subcommand seg1/ and PATTERN seg1
subcommand /seg2 and PATTERN seg2
subcommand seg1/seg2 and PATTERN seg1 seg2
Member name Any of these subcommands can select all members whose names
combination contain a range of characters and a pattern of characters by
specifying a member name segment, an asterisk and another
member name segment (either, but not both, of the member
name segments may be null).
Logic from DISPLAY and PATTERN subcommand selects members.
The subcommand processes these selected members in
alphabetic order. The following specifications select the same
member names:
subcommand seg1* and DISPLAY seg1 seg1
subcommand *seg2 and PATTERN seg2
subcommand seg1*seg2 and DISPLAY seg1 seg1 --with-- PATTERN
seg2
Member group The following examples each define and display a member group:
examples SUBCOMMAND MEMBERS IN THE GROUP
---------- --------------------
MEMBERS aa AA
MEMBERS (aa,bb) AA and BB
MEMBERS (aa,bb/) AA and members whose names contain BB
MEMBERS * current member group
MEMBERS current member group
MEMBERS = members in the current MEMLIST
Several StarTool FDM subcommands can modify data sets when they are allocated as
shared.
If the data set is allocated as OLD, the STOW DCB is left open after the first data set
update. For OLD allocations, exclusive use of the data set is assured and the following
RESERVE logic does not apply.
If the data set is allocated as SHR (SHR was specifically requested or SHR was defaulted
to), StarTool FDM subcommands that update the data set such as ALIAS, (with attributes
to be changed), COMBINE, COPY, DUP, DELETE, FIXPDS, RENAME, REPRO, RESTORE,
SEPARATE, or VERIFY (for update member PDS tests) could cause data set integrity
problems if the data set is also being updated by another user.
To circumvent this problem, StarTool FDM uses the following ISPF RESERVE logic to
maintain data set integrity during data set updates.
2 If the data set is a load library, then a linkage editor RESERVE or ENQUE is performed
as appropriate:
On a shared DASD volume,
RESERVE (SYSIEWLP,DSNAME,E,44,SYSTEMS),UCB=ADDRESS
On a non-shared DASD volume,
ENQ (SYSIEWLP,DSNAME,E,44,SYSTEM)
StarTool FDM displays a special panel when it encounters an ISPF dialog error. This panel
formats an error message, highlights important registers, and presents recovery options.
When StarTool FDM is executed as an ISPF dialog, attentions are not required since an
output loop is detected by the checkpoint processing of ISPMODE. If StarTool FDM or a
supporting TSO command is in a CPU loop (with no output), you need to interrupt the
process with an attention key or it continues indefinitely.
In general, an attention (the PA1 key) terminates the current StarTool FDM subcommand.
Two attentions in a row terminate the STARTOOL command. StarTool FDM performs
attention processing as follows:
1 A single (double for TSOEDIT) attention terminates any member group in progress
(except for the FSE subcommand).
5 For the COMPRESS or COPY subcommands, attentions are ignored until the attached
program terminates to protect the integrity of the target data set.
NOTE If you use IKJEFTSR authorize IEBCOPY for the compress or copy, attention
interrupts cannot be deferred; thus, do not use the attention key during a compress or
copy (a successful attention can destroy the data set).
6 For other StarTool FDM subcommands, a single (double for TSOEDIT) attention results
in a PDS300A ENTER OPTION prompt. The processing action taken at this point
depends on what is entered next:
Another attention terminates the StarTool FDM command
A null line causes the interrupted subcommand to continue at the point of
interruption. Any messages awaiting output at the time of the interrupt have already
been discarded.
If you enter a subcommand and the currently executing subcommand is external to
StarTool FDM (ABE, ACFCOMP, COMPARE, DCF, EXEC, FSE, HELP, PRINT, REVIEW,
SUBMIT, TSO xxx, TSOEDIT, TSOLIST or VPRINT), the subcommand processor forcibly
detaches and the ABEND message is suppressed
Give an entered subcommand control without delay
7 If an internal StarTool FDM subcommand is in a loop that does not involve input or
output to the terminal or input from the current data set, a single attention does not
terminate the loop:
The first attention provides the normal PDS300A ENTER OPTION prompt.
If you enter a subcommand at this time, StarTool FDM continues looping.
Another attention produces the message “PDS470W The program is probably in a
loop” and StarTool FDM performs the subcommand entered at the ENTER OPTION
prompt.
Press the HELP key (PF1) to bring up the ABEND Help panel.
StarTool FDM always attempts to recover from ABENDs with its ESTAE and ESTAI recovery
routines unless CONTROL NORECOVER is in effect. StarTool FDM performs ABEND
processing as follows:
1 The StarTool FDM program uses different recovery methods depending on the
subcommand being executed. The method used performs any cleanup and
reinitialization functions required to restart StarTool FDM.
For internal StarTool FDM subcommands, recovery is performed by writing an error
message and terminating the subcommand
For the external subcommands BROWSE, EDIT, or ISPF, no ESTAE recovery is
attempted; normal ISPF processing is permitted
For the other external StarTool FDM subcommands (ABE, COMPARE, COMPRESS,
COPY, DCF, EXEC, FSE, HELP, PRINT, REVIEW, SUBMIT, TSO xxx, TSOEDIT, TSOLIST,
and VPRINT), the subcommand processor is forcibly detached
3 If CONTROL RECOVER is in effect, any ABEND dump probably is not very useful. If
you want to use TSO TEST after an ABEND, set CONTROL NORECOVER first.
4 Certain external programs reached with the TSO subcommand (such as CALL)
terminates StarTool FDM with a READY message if the program they invoke ABENDS.
If you enter a null line at this point, StarTool FDM regains control.
5 The PDS999E message identifies the name of the StarTool FDM assembly listing
involved in the error as follows:
A
Alias member A member whose directory entry has an indicator value that indicates that the member
entry is an alternate name for a main member; a main member and its aliases are
associated with the same recorded data in a data set.
Apparent alias Data in a PDS that is pointed to by more than one main directory entry.
member
Associated Members with the same TTR address. For a main member, the associated members could
members be alias members or an apparent alias member; for an alias member, the associated
members could be other aliases or a main member.
B
Batch mode A mode of StarTool FDM operation. In batch mode, all user communication is performed
with PUTGET, GETLINE and PUTLINE TSO services. ISPF services are available. In this
mode of operation, StarTool FDM operates under control of the batch Terminal Monitor
Program (the TMP, or IKJEFT01).
BPAM An acronym for Basic Partitioned Access Method; BPAM is actually very similar in use to
BSAM which is for sequential data. StarTool FDM often uses BPAM for member check
operations and always uses BPAM for directory updates and reading PDSE data sets.
BSAM An acronym for Basic Sequential Access Method; StarTool FDM uses BSAM for several
utility functions.
C
CCHHR An acronym for Cylinder, Cylinder, Head, Head, Record which is a 10-byte hexadecimal
disk address relative to the start of the volume.
Command A request for an operation. For example, STARTOOL is a command and FIXPDS is a
StarTool FDM subcommand.
Compress A process that removes deleted members from a PDS. Disk space formerly occupied by
these deleted members is made available for new members. In a PDSE data set, space
from deleted members is managed dynamically; you cannot compress a PDSE.
D
Deleted Member data that is not pointed to by any directory entry; deleted members remain in a
member PDS until the data set is compressed. In a PDSE data set, space from deleted members is
managed dynamically; you cannot restore deleted members.
Directory A segment of a PDS that is a sequential data set with eight byte keys and 256 byte data
records containing pointers to data in the PDS member portion of the data set. For a
PDSE, PDS directory and member data is created in a virtual PDS data set.
Directory entry A logical entry in a PDS or PDSE directory that points to its associated data in the member
data; it consists of an eight character member name field and one or more three byte
relative address (TTR) fields.
DS1LSTAR A pointer in the data set control block (DSCB) that indicates the last used disk address for
a data set. This pointer is updated after a member is added to a PDS data set or after a
PDS is compressed.
E
EXCP An acronym for EXecute Channel Program. This access method is used extensively by
StarTool FDM to read an entire disk track with a single operation.
F
Function A request for an ISPF (or ISPMODE) operation. Most ISPMODE functions support their own
commands.
I
ISPMODE A mode of StarTool FDM operation. With ISPMODE, StarTool FDM operates as an ISPF
dialog and normal ISPF services (HELP, TSO, SPLIT, SWAP,...) as well as all StarTool FDM
services are available.
L
Line command A command entered on a table line in the CMD field. Line commands may be up to four
characters long.
Line mode A mode of StarTool FDM operation. In line mode, all user communication is performed
with PUTGET, GETLINE and PUTLINE TSO services. No ISPF services are available.
Load library A PDS or PDSE that has record format U and is commonly used to contain executable
modules.
M
Main member A non-alias directory entry and its associated recorded data.
Member Data in a PDS or PDSE that is pointed to by one or more directory entries. Members may
be alias or main members. Deleted members that have no associated directory entries.
For a PDSE, space from deleted members is managed dynamically; you cannot restore
deleted members or compress a PDSE.
Module A member contained in a load library. Also known as a load module or load member.
O
Orphan A member marked as an alias which does not have an associated main member.
member
P
PDS or A data set with fixed, variable or undefined format commonly used as a library for related
Partitioned types of information. Partitioned data sets contain two segments of data: a directory of
data set information and member data. This type of library is requested as DSNTYPE(PDS) in JCL
or a TSO ALLOCATE.
PDSE or An SMS managed data set logically similar to a PDS. This type of library is requested as
Partitioned DSNTYPE(LIBRARY) in JCL or on an ALLOCATE command. A PDSE can be accessed by
Data Set BPAM or BSAM access methods to obtain a virtual data set which looks like a PDS.
Extended
Q
QSAM An acronym for Queued Sequential Access Method; StarTool FDM uses QSAM for several
utility functions.
S
Source library A PDS or PDSE data set with fixed or variable format data; source libraries are used to
contain non-executable data.
StarTool FDM A multipurpose ISPF dialog and TSO command processor that manipulates data sets and
members individually or in groups.
Subcommand A request for an operation that is within the scope of work requested by the previously
issued command. STARTOOL is a command; FIXPDS is a StarTool FDM subcommand.
T
TTR An acronym for Track, Track, Record (a 1- to 6-digit hexadecimal disk address relative to
the start of the data set); this type of address is stored in the member directory entry to
indicate the start of a member.
C
A
CALC function 74
ABE subcommand 53 CAX function 75
ACFCOMP subcommand 54 line commands 77
add secondary space 183 CAX table
alias members 59 catalog status 76
ALIAS subcommand 55 catalog type 76
asterisks CHANGE subcommand 78
in member name matching 419 checkpoint 267
attention processing 425 CLIST conversion 108, 141
ATTRIB subcommand 60 CMDTBL function 80
line commands 83
primary commands 82
B table entries 82
combination member name 32
binder names 65 COMBINE subcommand 85
BLK3380 subcommand 65 Command
BLK3390 subcommand 67 ? 39, 42
BLK9345 subcommand 69 ADD 42, 260, 405
Block line command ALIASCHK 39, 42, 287
AA 126, 237, 244, 254, 291, 409 ALL 39, 42, 287
BB 126, 237, 244, 254, 291, 409 ALLOCERR 39, 42
CC 84, 126, 237, 244, 254, 316, 386, 409 ALTCMD 39, 42
DD 84, 291, 316 ALTERNAT 39, 42, 123, 235, 240, 250, 260,
DDEL 244, 254, 291 268, 287, 326, 384, 405
EE 126, 237, 244, 254, 291, 409 APPLY 39, 42, 76, 82, 117, 123, 235, 240,
GG 126, 237, 244, 254, 386, 409 250, 260, 288, 295, 384, 405, 414
HH 291 BASE 43, 414
LL 78, 118, 126, 237, 244, 254, 262, 291, BATCHJCL 43, 123, 235, 268, 288
386, 409, 415 BLKSIZE 39, 43
MM 84, 126, 237, 244, 254, 291, 316, 386, BOUNDS 43, 312
409 BUILD 43, 414
OO 78, 118, 126, 237, 244, 254, 262, 291, CAN 39, 43, 268
296, 386, 409, 415 CANCEL 43, 313
PP 291 CAX 76
RR 84, 316, 409 CB 43, 313
SS 78, 119, 126, 237, 245, 254, 262, 291, CBMAP 43, 313
386, 409 CHANGE 43, 313
SSEE 126, 237, 245, 254, 409 CISIZE 39, 43
TT 291 CLOSE 43, 313
UU 126, 238, 245, 254, 409 COLS 43, 44, 268, 306
VV 291, 409 COMMENT 39, 44
XX 78, 84, 119, 126, 238, 245, 254, 262, COMPRESS 44, 123, 235, 240, 250, 405
291, 296, 386, 410, 415 CONTINUE 44, 268
ZZ 126, 238, 254, 410 COPYBOOK 44, 313
TRANS 41, 51 E
TRAP 41, 51
User 271 EDIT subcommand 150
UT 41, 51, 77, 118, 125, 236, 242, 252, 261, EDREC subcommand 153
269, 271, 289, 296, 407, 415 ENCODE subcommand 154
VERTICAL 51, 316 END subcommand 155
WEEK 41, 51, 289 equal symbol 32
WHOHAS 51, 242, 252, 407 EXCLUDE subcommand 156
X 42, 51, 75, 77, 83, 118, 125, 196, 236, EXEC subcommand 162
243, 252, 261, 269, 289, 296, 326, extended copybook mode 312
385, 407, 415 line commands 312
XALL 42, 51, 75, 77, 83, 118, 125, 196, 236, extended copybooks
243, 252, 261, 269, 289, 296, 326, using 312
385, 407, 415
XCOPY 42, 51
XMIT 42, 51 F
YES 52, 269
ZAP 52, 415 FILTER function 165
commands 42 FIND subcommand 167
block line commands 53 abbreviations 167
defined 53 aliases 167
line commands 53 defaults 167
COMPARE subcommand 88 keywords 176
COMPDIR subcommand 89 operands 169
COMPRESS subcommand 93 remarks 175
CONDEND subcommand 95 syntax 167
CONTROL subcommand 97 FINDMOD subcommand 178
COPY subcommand 104 FIXPDS BLKSIZE and device table 185
copybook mode 312 FIXPDS subcommand 180
extended 312 FSE subcommand 189
normal 312 Function
vertical 312 CALC 74
CREATE subcommand 112 CAX 75
CSECTS function 115 CMDTBL 80
block line commands 118 CSECTS 115
line commands 118 DDNAME 122
primary commands 117 FILTER 165
GO 192
HEX 195
D ISPMODE 221
ISPXEQ 222
DCF subcommand 121 LISTA 232
DDNAME function 122 LISTC 239
DECODE subcommand 127 LISTF 248
default member names 31 LISTV 258
DELETE subcommand 128 MASK 276
deleted member 128, 266, 290, 347 MEMLIST 279
DELINK subcommand 130 NUCMAP 294
DFHSM 243, 252, 326, 385, 407 PBROWSE 303
DIRENTRY subcommand 131 PEDIT 307
DISASM subcommand 132 PROFMAN 325
DSAT subcommand 136 PVIEW 321
DSNAME subcommand 140 STATUS 364
DUP subcommand 141 VIEW 266
DVOL subcommand 148 VMAP 383
Dynamic command 271 WORKPAD 403
ML 125, 237, 243, 253, 290, 385, 408 block line commands 126, 237
MOD 125, 237, 244, 253, 386, 408 line commands 125, 236
O 77, 118, 125, 237, 244, 253, 261, 290, primary cmmands 235
291, 296, 327, 386, 408, 415 primary commands 123
PAN 290 LISTC function
PBRO 408 block line commands 244
PBROWSE 244, 253 line commands 243
PEDI 408 primary commands 240
PEDIT 244, 253 LISTF function 248
PVIE 408 block line commands 254
R 83, 118, 316, 409 line commands 252
RACF 244, 253 primary commands 250
REFR 244, 253, 261 LISTGRP subcommand 257
REN 244, 253 LISTV function 258
REPL 409 block line commands 262
REST 291, 386 line commands 261
RJCL 386 primary commands 260
S 77, 118, 125, 237, 244, 253, 261, 290, LKED value
327, 386, 409 in message PDS046I 65
SEEK 125, 237, 244, 253, 409 LLA subcommand 264
SEPA 409
SETA 125, 237, 244, 253, 409
SMPG 409 M
SPAC 261
STAT 261 MAP subcommand 272
SUBL 409 MASK function 276
SWAP 290 matches
TAG 77, 83, 118, 125, 237, 244, 253, 261, character string 32
290, 296, 409, 415 key 72, 109
U 125, 237, 244, 253 string 75, 77, 83, 117
UNC 244, 253, 386 matching
UNDO 415 keys 73
UP 409 Maxspace 183
US 409 member group
UT 78, 118, 126, 237, 244, 253, 261, 290, defined 417
386, 409 member groups 31
VERI 409 member name list 32
VIEW 409 member name matching 419
VMAP 261 member name range 32
VSAM 244, 253 member names
VTOC 262 default 31
VUSE 262 hexadecimal 31
W 126, 237, 244, 253, 290, 386 members
WHO 126, 237, 244, 253, 386, 409 alias 59
X 78, 84, 118, 126, 237, 244, 253, 262, 290, MEMBERS subcommand 278
291, 296, 327, 386, 409, 415 MEMLIST function 279
XCOP 126, 237, 244, 253 modify load attributes 60
XMIT 244, 253, 290 modify source attributes 57
Z 126, 237, 244, 253, 386, 409
ZAP 118
line commands N
defined 53
linkage editor 65 NUCMAP function 294
LIST subcommand 225
LISTA function 232
LISTA/DDNAME function
LISTF 248 T
LISTGRP 257
LISTV 258 TSO subcommand 369
LLA 264 TSOEDIT subcommand 370
MAP 272 TSOLIST subcommand 372
MASK 276
MEMBERS 278
MEMLIST 279 U
NUCMAP 294
OPTIONS 299 underlines 39
OUTCOPY 300 underscores 137
PATTERN 302 in member name matching 419
PBROWSE 303 update
PEDIT 307 COPY 111
PGMDOC 322 SEPARATE 354
PRINT 323 update protection 421
PROFMAN 325 USAGE
PVIEW 321 message PDS292I 403
QUIT 329 USAGE subcommand 373
READOBJ 329
RECALL 331
RENAME 332 V
REPLACE 334
REPRO 345 VERIFY subcommand 377
RESTORE 347 vertical copybook mode 312
REVIEW 351 VIEW Function 266
SCRATCH 128 VMAP function
SEPARATE 353 block line commands 386
SMPGEN 356 line commands 385
STATUS 364 primary commands 384
SUBLIST 361 VPRINT subcommand 389
SUBMIT 363 VTOC subcommand 391
SVCMAP 366 VUSE subcommand 399
TSO 369
TSOEDIT 370
TSOLIST 372 W
USAGE 373
WHOHAS
VERIFY 377
message PDS292I 403
VIEW 266
WHOHAS subcommand 402
VMAP 383
WORKPAD function 403
VPRINT 389
block line commands 409
VTOC 391
line commands 407
VUSE 399
primary commands 405
WHOHAS 402
WORKPAD 403
XREF 410
ZAP 413
X
subcommands 32, 53 X line commands 53
defined 53 XREF subcommand 410
SUBLIST subcommand 361 XX block line commands 53
SUBMIT subcommand 363
SVCMAP subcommand 366
Z
ZAP function 413
block line commands 415