SDSF for New Users Lab
Session 2236
Chip Wood/Tom Wasik
SDSF Development
IBM Poughkeepsie
Objectives
Explain SDSF to the new and/or
inexperienced users:
End users
Operators
System programmers
Along the way, include tips for
everyone
2236: SDSF for New Users Lab
System Display and Search
Facility
SDSF provides an easy & efficient way to:
Control job processing
Control output and browse jobs, without
printing
Control devices such as printers, lines, and
initiators
Manage system resources
2236: SDSF for New Users Lab
SDSF Organizes Data
Data is presented in tabular format on
20+ different panels
Panels are customizable by the system
programmer and the user
SDSF security controls the panels users
see and the functions they can use
2236: SDSF for New Users Lab
SDSF Panels - Layout
Display Filter View Print Options Help Select a
function
-----------------------------------------------------
SDSF DA AQTS SYS1 PAG 10 SIO 113 CPU 114/007
COMMAND INPUT ===>_ Type
NP JOBNAME SysName Real Paging SIO CPU% SrvClass
SDSF and
*MASTER* AQFT 10T 0.00 7.06 0.15 SYSTEM
system
*MASTER* AQTS 3594 0.00 0.12 0.04 SYSTEM
commands
ABOWEN AQTS 742 0.00 0.00 0.00 TSOPRIME
ADAM AQTS 1310 0.00 0.00 0.00 TSOPRIME
ADANPL AQTS 1128 0.00 0.00 0.00 TSOPRIME
More
ADINELL AQTS 564 0.00 0.00 0.00 TSOPRIME
ADOOLEY AQFT 1472 0.00 0.00 0.00 TSOPRIME
Type short
Sysplex-wide data, Modify values
commands
current and by typing over
here
customizable them
2236: SDSF for New Users Lab
Tip: Alternate Field Lists
Every panel has two sets of columns,
a primary and a secondary
Secondary includes things like output
descriptors (Programmer name, Room
number, Account number, etc.) that may
take longer to obtain
Access the secondary set with ?
2236: SDSF for New Users Lab
SDSF Users
SDSF provides function for
End users
Operators
System programmers
System programmers can define any number
of groups of users. This presentation assumes three
typical groups.
2236: SDSF for New Users Lab
SDSF for End Users
Work with jobs and output:
• Display jobs on a specific queue
• Display jobs anywhere in the system
• Display just your own jobs
• Display output as it is created
• Find out if jobs are waiting to be
processed
2236: SDSF for New Users Lab
SDSF Menu for End Users
Display Filter View Print Options Help
-------------------------------------------------
HQX7760 --------- SDSF PRIMARY OPTION MENU ------
Menu shows just
COMMAND INPUT ===> job & output panels
(limited by security)
DA Active users
I Input queue
O Output queue JES3 display is a
H Held output queue
subset (DA, I, ST)
ST Status of jobs
2236: SDSF for New Users Lab
Monitor Jobs
Display Filter View Print Options Help
------------------------------------------------------
SDSF STATUS DISPLAY ALL CLASSES LINE 1-20 (24651)
COMMAND INPUT ===> SCROLL ===> PAGE
NP JOBNAME JobID Owner Prty Queue C
BKELLER TSU23637 BKELLER 15 EXECUTION
BKELLERA JOB23991 SCHED 15 INPUT J
Status (ST) panel shows jobs no matter where
they are in the system
DA panel shows active jobs
I shows jobs on the input queue
2236: SDSF for New Users Lab
Control Jobs
With “action characters” and overtypeable fields,
users can:
•Cancel, hold or release jobs
•Change a job's priority, class, or destination
COMMAND INPUT ===>
NP JOBNAME JOBID OWNER PRTY C
C WLMBKP# JOB32343 THERESA 7 D
WLMBKP# JOB30138 THERESA 7 A
SDSF generates the system command for you.
2236: SDSF for New Users Lab
Work with Data Sets
The ? action lists the data sets for a job:
SDSF JOB DATA SET DISPLAY - JOB BERKEA5 (JOB00042)
COMMAND INPUT ===> SCROLL ===> PAGE
NP DDNAME StepName ProcStep DSID Owner C Dest
JESJCLIN 1 BEVK R LOCAL
JESMSGLG JES2 2 BEVK R LOCAL
JESJCL JES2 3 BEVK R LOCAL
JESYSMSG JES2 4 BEVK R LOCAL
$INTTEXT JES2 5 BEVK A LOCAL
ISFIN FINDDA 101 BEVK R LOCAL
xdc ISFOUT FINDDA 104 BEVK R LOCAL
Browse, print, purge release Change class, dest,
output descriptors
2236: SDSF for New Users Lab
Monitor Output
The O panel displays information about
output that is ready to be printed.
Display Filter View Print Options Help
-------------------------------------------------------
SDSF OUTPUT ALL CLASSES ALL FORMS LINES 1,442
COMMAND INPUT ===> SCROLL ===> PAGE
NP JOBNAME Max-RC C Forms JobID Tot-Rec
BKELLERA CC 0000 A REC JOB18690 1,178
BKELLERB ABEND S622 A REC TSU01320 485
High return code
Classes & forms
Total # lines to be printed
2236: SDSF for New Users Lab
Tip: See all output on H
H panel shows held output.
Note, H has a built-in filter that limits it to your
own jobs.
To display output for all jobs on the H panel:
• prefix ** then h
- or –
• prefix then h all
2236: SDSF for New Users Lab
Control Output
With action characters and overtypes users can:
• Hold output
• Purge output
• Change output's class, destination or forms
• Set output descriptors for separator pages
• Browse output before it is printed
NP JOBNAME JOBID OWNER PRTY C
S BKELLERZ JOB32343 BKELLER 7 D
WLMBKP# JOB30138 KJONAS 7 D
2236: SDSF for New Users Lab
Browse Output
•Output data sets
•Input data sets for jobs being processed or waiting to be processed
SDSF OUTPUT DISPLAY BKELLERZ JOB32343 DSID 2
COMMAND INPUT ===>
09.25.05 JOB32343 IRR010I USERID BKELLER IS ASSIGNED
09.25.06 JOB32343 ICH70001I BKELLER LAST ACCESS AT Job
09:
log
09.25.06 JOB32343 $HASP373 BKELLERZ STARTED - INIT 12 -
09.25.07 JOB32343 IEF403I BKELLERZ - STARTED - TIME=09.
--------------------------------------------------------
1 //BKELLERZ JOB '141691,B001D49A','WR KELLER'
// JCL
MSGCLASS=H,NOTIFY=BKELLER,CLASS=T
2 //OUT OUTPUT FORMDEF=010111,PAGEDEF=V06481
--------------------------------------------------------
16 IEFC001I PROCEDURE COMPARE WAS EXPANDED USING
ICH70001I BKELLER LAST ACCESS AT 09:25:06 ON MONDAY, Messages
2236: SDSF for New Users Lab
ISPF Edit or Browse
Instead of S, you can use
SE to browse using ISPF Edit
SB to browse using ISPF Browse
Then you can use any ISPF Edit or Browse
commands or macros
2236: SDSF for New Users Lab
Browse JCL and Resubmit
• With the SJ action, you can browse just the
JCL for a job and resubmit it.
SDSF EDIT HOLDE (JOB00017) JCLEDIT Columns 00001 00072
Command ===> SUB Scroll ===> PAGE
****** ***************************** Top of Data ***********************
000001//HOLDE JOB CLASS=E,MSGCLASS=E
000005 //STEP1EXEC PGM=IEBDG
000006 //OUTA DD SYSOUT=E,DCB=(LRECL=80,RECFM=FB,BLKSIZE=800)
000007 //SYSPRINT DD SYSOUT=E
000008 //SYSIN DD *
•Uses ISPF Edit
•Changes you make are not saved
2236: SDSF for New Users Lab
Printing
You can print:
Output data
Data from the log panels
Screen images of SDSF panels
The print output can be sent to:
SYSOUT
Data set
Print file (specified with a ddname).
2236: SDSF for New Users Lab
Printing – Fast Path
SDSF OUTPUT ALL CLASSES ALL FORMS LINES 499 LINE 1-2 (18)
COMMAND INPUT ===>
NP JOBNAME JOBID OWNER PRTY C FORMS FCB DEST
TCAS STC00007 IBMUSER 144 A STD **** LOCAL
XDC CLRMANB STC00009 +++++++ 144 A STD **** LOCAL
Print with the X action
Print from browse
SDSF OUTPUT DISPLAY BKELLERZ JOB32343 DSID 2
COMMAND INPUT ===> print
09.25.05 JOB32343 IRR010I USERID BKELLER IS ASSIGNED
09.25.06 JOB32343 ICH70001I BKELLER LAST ACCESS AT 09:
09.25.06 JOB32343 $HASP373 BKELLERZ STARTED - INIT 12 -
09.25.07 JOB32343 IEF403I BKELLERZ - STARTED - TIME=09
2236: SDSF for New Users Lab
Printing - Control
PRINT command and pop-ups provide more control:
SDSF Open Print
COMMAND INPUT ===>
Enter SYSOUT attributes below:
Class ===> (A through Z, 0 through 9)
Copies ===> (1to 255)
Forms ===> **
Destination ===>
FCB ===>
UCS ===>
Process Mode ===> **
Pagedef ===> **
Formdef ===> **
2236: SDSF for New Users Lab
Tip – Printing As Is
SDSF's print function inserts ANSI carriage control,
or converts machine carriage control, if present, to
ANSI, unless:
•You use the PRINT FILE command or the XF or
XFC action character
•The data is page-mode. SYSOUT files containing
both page-mode data and machine character data are
not defined as page-mode in JES2.
2236: SDSF for New Users Lab
Customizing Panels
Use commands to show just your own jobs
•System programmer can also limit jobs
SDSF STATUS DISPLAY ALL CLASSES
COMMAND INPUT ===>
NP JOBNAME JobID Owner Status Prty Queue
BKELLER TSU23995 BKELLERFilter on owning userid:
BKELLER JOB13185 BKELLEROWNER BKELLER
BKELLER JOB06091 BKELLER
BKELLERA JOB30922 BKELLER
Filter on job name:
PREFIX BKELLER*
2236: SDSF for New Users Lab
Customizing Panels
Filter by any column or combination
of columns, including boolean operators
Sort using 1 or 2 columns
Set screen colors and other attributes
2236: SDSF for New Users Lab
Customizing Panels
Arrange Pop-up
Arrange and resize
columns Column Width
__ SysName 8
/_ Real 4
Move __ Paging 6
__ SIO 6
Real
__ CPU% 6
after
__ SrvClass 8
Stepname a_ StepName 8
__ ProcStep 8
__ Owner 8
Change widths __ Status 6
__ C 1
2236: SDSF for New Users Lab
Customizing Panels
Filter Row 1 to 9 of 25
Command ===>
Type filter criteria. Type a / in the Column or Oper
fields for valid values. Press F11/23 to clear all
filter criteria.
Filtering is ON
2236: SDSF for New Users Lab
Tips – Other settings
•Display action characters: set action (long|short)
SDSF HELD OUTPUT DISPLAY ALL CLASSES LINES 452,893 LINE 429-449 (449)
COMMAND INPUT ===> SCROLL ===> CSR
ACTION=//-Block,=-Repeat,+-Extend,?-JDS,A-Release,C-Cancel,H-Hold,L-List
ACTION=O-Release,P-Purge,Q-Outdesc,S-Browse,X-Print
NP JOBNAME JOBID OWNER PRTY C ODISP DEST TOT-REC
DB2LU32 JOB09111 DB2JOB 7 H HOLD LOCAL 730
•Display settings: set display
SDSF STATUS DISPLAY ALL CLASSES LINE 1-20 (24651)
COMMAND INPUT ===> SCROLL ===> PAGE
PREFIX=BKELLER* DEST=(ALL) OWNER=* FILTERS=2
NP JOBNAME JobID Owner Prty Queue C
BKELLER TSU23637 BKELLER 15 EXECUTION
2236: SDSF for New Users Lab
Tips – Other settings
Require confirmation of destructive actions
•Set confirm displays a confirmation pop-
up for cancel & purge on job and output
panels
Control cursor placement
•Set cursor on keeps the cursor on the
row you are working with
2236: SDSF for New Users Lab
SDSF for Operators and
System Programmers
Monitor and control:
• Initiators
• Printers SDSF PR DISPLAY
NP NODE
DEVICE STATUS UNIT
• Punches SDSF DISPLAY
NP LINE
DEVICE STATUS UNIT
• Readers SDSF DISPLAY
LINE1
NP DEVICE
ACTIVE B00
L1.JR1STATUS
INACTIVE UNIT
• Lines LINE1 ACTIVE
L1.JT1 INACTIVE
L1.JR1 INACTIVE
B00
• Nodes LINE1
L1.SR1ACTIVE
L1.JT1 ACTIVE
INACTIVE
L1.JR1 INACTIVE
B00
L1.ST1 ACTIVE
• etc. L1.SR1 ACTIVE
L1.JT1 INACTIVE
L1.ST1 ACTIVE
L1.SR1 ACTIVE
L1.ST1 ACTIVE
2236: SDSF for New Users Lab
SDSF for Operators and
System programmers
HQX7760------- SDSF PRIMARY OPTION MENU -------------
COMMAND INPUT ===>_ SCROLL ===> PAGE
DA Active users INIT Initiators
I Input queue PR Printers
O Output queue PUN Punches
H Held output queue RDR Readers Devices
ST Status of job LINE Lines
NODE Nodes
LOG System log SO Spool offload
SR System requests SP Spool volumes
MAS Members in the MAS
JC Job classes ULOG User session log
SE Scheduling environments
RES WLM Resources
ENC Enclaves
PS Processes
System resources
2236: SDSF for New Users Lab
Control Devices
Information displayed about devices includes:
• Status and characteristics (such as selection criteria)
• The job currently being processed
Control with action characters and overtypes
SDSF PRINTER DISPLAY LINE 33-54 (102)
COMMAND INPUT ===> SCROLL ===> PAG
NP PRINTER STATUS SFORMS SCLASS JOBNAME JOBID
PRT33 ACTIVE STD UIC12 TDOOLY JOB02733
PRT34 ACTIVE NAR UIC12 KHODGE JOB02539
Start, stop,
forward space, etc. Overtype to change attributes
2236: SDSF for New Users Lab
Tip – Overtype Extension
Work with fields that have multiple values
SDSF PRINTER DISPLAY SY1
COMMAND INPUT ===>
Type +
PREFIX=* DEST=
alone
(ALL) ,-------------------------------,
NP PRINTER SPrMode1 | Overtype Extension
|
PRT1 + |
|
PRT2 LINE | Column SPrMode1
Pop-up
|
shows all
PRT3 LINE | Maximum length 8
values
|
PRT4 LINE | |
PRT5 PAGE | Type values or use blanks to
|
PRT6 PAGE | erase values.
| 2236: SDSF for New Users Lab
Control System Resources
• Members in the MAS
• Spool volumes
• Job classes
SDSF MAS DISPLAY S32 DEFINED SYSTEMS 9% SPOOL
COMMAND INPUT ===> SCROLL ==> PAGE
NP NAME STATUS SID PREVCKPT HOLD ACTHOLD
S01 ACTIVE 1 26.75 0 6
S02 ACTIVE 2 37.72 0 5
S03 INACTIVE 3 0.00 0 0
2236: SDSF for New Users Lab
More than JES Data
WLM enclaves, scheduling environments
and resources
Unix System Services process
SDSF PROCESS DISPLAY SY1 ALL LINE 1- 10 (10)
COMMAND INPUT===>_ SCROLL===> CSR
NP JOBNAME Status Owner State CPU-
BPXOINIT SWAPPED, RUNNING SYSTASK MRI 1
MQS1CHIN RUNNING MQS 1R 11
MQS1CHIN RUNNING MQS 1R 12
MQS1CHIN FILE SYS KERNEL WAIT MQS 1F 20
KDMQDKJ RUNNING SYSTASK HR
2236: SDSF for New Users Lab
View the System Log
•View the system log online
•View a merged sysplex log (LOG O)
COMMAND INPUT===> FIND HASP395 SCROLL===> CSR
Search log data
N 4000000 AQFT 01303 16:37:20.94 JOB23185 00000091 $HASP395 DIANAM ENDED
NC0000000 AQFT 01303 16:37:21.33 INTERNAL 00000281 SE '16.37.21 JOB23185
N 0000000 AQFT 01303 16:37:21.37 TSU21704 00000081 IEF126I RIMFIRE - LOGG
N 4000000 AQFT 01303 16:37:21.37 TSU21704 00000091 $HASP395 RIMFIRE ENDED
N 0000000 AQFT 01303 16:37:26.65 00000291 IEA989I SLIP TRAP ID=X33
N 0200000 AQFT 01303 16:37:29.08 JOB23211 00000081 $HASP100 D75CEM1C ON I
8000000 AQFT 01.10.09 STC17351 *60 DSI802A CNM03 REPLY WITH VALID NCCF SY
WTORs listed
8000000 AQFT 01.04.42 *57 DSI802A M03AO REPLY WITH VALID NCCF SY
0002000 AQFT 01.49.45 STC15235 *12 DENQ002D ENQ Monitor - Reply 'ENQ' or
below the
******************************** BOTTOM OF DATA *************************
log data
2236: SDSF for New Users Lab
Tip – Auto-refresh the Log
New log data is added to the bottom
& command repeats a command at an interval
COMMAND INPUT===> BOT &15 SCROLL===> CSR
Scroll the log
N 4000000 AQFT 01303 16:37:20.94 JOB23185 00000091 $HASP395 DIANAM ENDED
NC0000000 AQFT 01303 16:37:21.33 INTERNAL 00000281 SE '16.37.21 JOB23185 $H
to the bottom
N 0000000 AQFT 01303 16:37:21.37 TSU21704 00000081 IEF126I RIMFIRE - LOGGED
N 4000000 AQFT 01303 16:37:21.37 TSU21704 00000091 $HASP395 RIMFIRE ENDED
every 15 seconds
N 0000000 AQFT 01303 16:37:26.65 00000291 IEA989I SLIP TRAP ID=X33
N 0200000 AQFT 01303 16:37:29.08 JOB23211 00000081 $HASP100 D75CEM1C ON INT
8000000 AQFT 01.10.09 STC17351 *60 DSI802A CNM03 REPLY WITH VALID NCCF SY
8000000 AQFT 01.04.42 *57 DSI802A M03AO REPLY WITH VALID NCCF SY
0002000 AQFT 01.49.45 STC15235 *12 DENQ002D ENQ Monitor - Reply 'ENQ' or 'E
******************************** BOTTOM OF DATA ****************************
2236: SDSF for New Users Lab
Work with Action Messages
SR panel shows system requests
SDSF SYSTEM REQUESTS ALL 6 WTORS LINE 1-16 (16)
COMMAND INPUT ===> SCROLL ===> CSR
NP REPLYID SysName JobName Message-Text
r 43 AQTS AUTONET *43 DSI802A M05AO REPLY WITH
52 AQTS WHOSP2 *52 DENQ002D ENQ Monitor – R
53 AQTS NETVNET *53 DSI802A CNM05 REPLY WITH
R action displays a pop-up for
replying to the message
2236: SDSF for New Users Lab
View a Log for Your Session
ULOG captures commands and msgs. for a user.
Display Filter View Print Options Help
Generated
command
----------------------------------------------------------------------
SDSF ULOG CONSOLE BKELLER LINE 0 COLUMNS 02- 81
COMMAND INPUT ===> SCROLL ===> CSR
********************************* TOP OF DATA *********************
AQFT 2004040 17:30:22.29 ISF031I CONSOLE BKELLER ACT
AQFT 2004040 17:30:55.58 -$CJ(5903),P Messages
AQFT 2004040 17:30:55.59 JOB05903 $HASP890 JOB(BKELLER)
$HASP890 JOB(BKELLER) STAT
$HASP890 PRIO
$HASP890 PURG
AQFT 2004040 17:31:53.22 -$RALL,J=J30922,D=BKELLER
AQFT 2004040 17:31:53.72 $HASP000 OK
******************************** BOTTOM OF DATA ******************
2236: SDSF for New Users Lab
System commands - /
Enter system commands from within SDSF
COMMAND INPUT ===> /setprog apf,add,ddname=isf +
Type /, then cmd. Trailing + displays the pop-up
System Command Extension
Type or complete typing a system command, then press Enter.
===> setprog apf,add,ddname=isf.isfload,vol=us1
===>______________________________________
Place the cursor on a command and press Enter to retrieve it.
More: +
=> D IPLINFO Previous
=> $JDDETAILS
=> $jdhistory commands
2236: SDSF for New Users Lab
Customizing SDSF
System programmers use SDSF’s internal parameters,
ISFPARMS, to customize SDSF:
Global initialization values (data set names, etc.)
Columns on SDSF panels
Action bar on or off, confirmation on or off, etc.
Systems to include
2236: SDSF for New Users Lab
ISFPARMS example (excerpt)
GROUP TSOAUTH(JCL,OPER,ACCT),
XUID(XLIST),
AUTH(LOG,I,O,H,DA,INIT,PR,NO,DEST),
IFIELDS(DFLD)
NTBL NAME(XLIST)
NTBLENT STRING($S),OFFSET(1)
NTBLENT STRING(OPER),OFFSET(3)
FLD NAME(DFLD) TYPE(IN)
FLDENT COLUMN(JNUM),TITLE('JOB NUM'),WIDTH(7)
FLDENT COLUMN(JPRIO),TITLE(PRTY),WIDTH(4)
Columns definition
Name list used in group definition
Group definition
2236: SDSF for New Users Lab
Processing ISFPARMS
Processed by an SDSF server (address space)
at initialization
Server reads from PARMLIB member
ISFPRMxx or from a PDS defined in the server
JCL.
•Can specify the xx suffix when starting the
server, for example s sdsf,m=01
Note: ISFPARMS can also be coded with ASSEMBLER macros
2236: SDSF for New Users Lab
Controlling the SDSF Server
START proc-name to start the server
•Example: s sdsf
MODIFY server-name to refresh the
statements or check syntax without activating
•Example: f sdsf,refresh,test
STOP server-name to stop the server
•Example: p sdsf
2236: SDSF for New Users Lab
Providing Security
ISFPARMS
•Combination of group definitions and auth lists
SAF
Recommended!
•Dynamic
•Granular
•Better audit trail
•Falls back to ISFPARMS when there is no
decision
2236: SDSF for New Users Lab
SDSF in the Sysplex
Job and output displays are MAS-wide automatically
Device displays can be made sysplex-wide. Requires:
•WebSphere MQ on each system
•SDSF server
SYSNAME command then controls which systems are
included
SDSF Customization Wizard helps set-up
•www.ibm.com/servers/eserver/zseries/zos/sdsf/
2236: SDSF for New Users Lab
Sysplex-wide data
With the addition of WebSphere MQ,
users can work with devices anywhere
in the sysplex.
SDSF LINE DISPLAY SY1 LINE 1-5 (5)
COMMAND INPUT ===> SCROLL ===> CSR
NP DEVICE Status SysName Unit Node Jobname
LINE1 ACTIVE SY1 SNA
LINE2 ACTIVE SY1 F00C
LINE3 ACTIVE SY1 F012 POKVMXA1
LINE10 DRAINED SY2 0406
LINE11 DRAINED SY2 0407
2236: SDSF for New Users Lab
Rexx Support
SDSF allows panels to be accessed via
REXX APIs
/* Sample to display top 10 users of spool space */
rc=isfcalls('on') /* Enable SDSF environment */
isfcols = 'JNAME JOBID TGNUM TGPCT' /* Limit columns returned */
isfsort = 'TGNUM D' /* Sort results (TGNUM column, descending order */
Address SDSF 'ISFEXEC ST' /* Access ST panel */
do ix=1 to min(10,JNAME.0) /* JNAME.0 is number of rows returned */
Say JOBID.ix JNAME.ix 'uses' TGNUM.ix 'track groups ('TGPCT.ix'%)'
end
rc=isfcalls('off')
2236: SDSF for New Users Lab
Where to Learn More
Online interactive tutorial demonstrates the most
common tasks. TUTOR command
Help panels describe SDSF panels, commands, and
messages. PF1 or Help command
SDSF Operation and Customization provides detailed
information for the system programmer
The SDSF Web site has tips, presentations, & links:
www.ibm.com/servers/eserver/zseries/zos/sdsf/
2236: SDSF for New Users Lab
