z/OSMF considerations

Requirements

Adding the SDSF task to z/OSMF

To add the SDSF task to z/OSMF, you import a properties file through the Import Manager task of z/OSMF, which is in the z/OSMF Administration category. This process is described in the z/OSMF online help.

The properties file for SDSF is /usr/lpp/sdsf/zosmf/sdsf.properties. Specify this file name in the Import dialog.

The import is generally a one-time process. The SDSF plug-in only needs to be imported the first time you are installing SDSF or after you have deleted the plug-in and want to restore it.

Defining required settings for the SDSF task

Before selecting the SDSF task the first time, you must define some settings. To do this, expand the z/OSMF Settings category, then select SDSF Settings. Supply a value for each required field. The settings are saved across sessions.

For TSO logon proc, you can specify any logon proc for which the user is authorized that is suitable for SDSF, as long as it contains either a //SYSEXEC or //SYSPROC that references data set ISF.SISFEXEC.

You do not need to create a new logon procedure for exclusive use of the z/OSMF SDSF task.

//SDSF EXEC PGM=IKJEFT01,DYNAMNBR=500
//SYSEXEC DD DISP=SHR,DSN=ISF.SISFEXEC

The SDSF task does not use ISPF, so ISPF allocations are not required. If you use a logon proc that includes ISPF allocations, ensure that the allocations can be shared between the launched TSO address space and a standard TSO login. In particular, ensure that any ISPF profile allocation will allow both the launched TSO address space and the standard login to proceed.

If your logon proc invokes an initial command (using the PARM= keyword on the EXEC statement), the command must return to the TSO READY prompt. When the logon completes, SDSF waits for the TSO READY prompt before proceeding.

If the logon fails when launching the SDSF task, click the TSO Messages link to view TSO messages that were issued during logon. Common errors preventing a successful launch include a JCL error in the logon proc, an invalid account number, and a missing ISF.SISFEXEC data set in the //SYSEXEC concatenation.

Reviewing z/OS Unix System Services settings

SDSF uses the z/OS Unix System Services interprocess communications (IPC) message queue for communications between SDSF and z/OSMF. The maximum message size is controlled by the size of the queue defined by the IPCMSGQBYTES option of PARMLIB member BPXPRMxx.

Message sizes used by SDSF vary based on the request type and amount of data returned in the response. You should review the setting of IPCMSGQBYTES on your system (using the D OMVS,O operator command) to ensure it is large enough for the messages sent by SDSF.

For details, refer to the topic about BPXPRMxx in z/OS MVS Initialization and Tuning Reference.

Protecting SDSF function in z/OSMF

The function provided by the SDSF task in z/OSMF is protected just as z/OS SDSF is protected, with the same SAF resources and ISFPARMS parameters. To control which group in ISFPARMS a user is assigned to, you can use either:

• SAF.

  To determine group membership, SDSF checks the SAF resource GROUP.group-name.server-name in the SDSF class. This is explained in detail in Using SAF to control group membership.

• The TSOAUTH parameter of the ISFGRP statement in ISFPARMS.

  For more information, refer to Group membership.

Using SAF is the recommended approach, as it is more dynamic and allows you to assign users to the same group regardless of the environment from which they invoke SDSF.

To hide SDSF functions that you are not authorized to, you can use Authorization preferences in the SDSF Settings task.

Using the SDSF task in z/OSMF has these new requirements:

• You must have access to resources in the ZMFAPLA class.

  Table 1. Resources in the ZMFAPLA Class

  z/OSMF Task	Resource	Access Required	Class
  SDSF	saf-prefix.ZOSMF.IBMSDSF.JOBS	READ	ZMFAPLA
  SDSF Settings	saf-prefix.ZOSMF.IBMSDSF.SETTINGS	READ	ZMFAPLA

  You configure saf-prefix in z/OSMF. The default is IZUDFLT.
• Your user ID must be connected to the IZUUSER group.

Access to views in z/OSMF is protected in the same way as the corresponding panel command in z/OS SDSF. For a description of protecting SDSF commands with SAF, refer to Authorized SDSF commands. For a description of protecting SDSF commands with the AUTH parameter of ISFPARMS, refer to Group function parameters reference.

Table 2. z/OSMF Views and Corresponding z/OS SDSF Commands

View	SDSF Command
Active Jobs	DA
All Jobs	ST
Input Queue	I
Output Queue	O
Held Output Queue	H
Address Space Memory	AS
Unix Processes	PS
Health Checks	CK
System Information	SYS
Spool Data Sets	SP
CF Structures	CFS
APF Data Sets	APF
LNK Data Sets	LNK
LPA Data Sets	LPA
PAG Data Sets	PG
PARM Data Sets	PARM
Network Activity	NA
SMS Storage Groups	SMSG
Device activity	DEV

Modifying values in tables or on property sheets in z/OSMF is protected in the same way as overtyping fields in z/OS SDSF. The columns have the same titles in z/OSMF as in z/OS SDSF. For more information about protecting overtyping fields with SAF, refer to Overtypeable fields. With ISFPARMS, overtyping fields is protected with the CMDLEV parameter. Refer to Action characters and overtypeable fields for each command level for more information.

Actions on tables in z/OSMF are protected in the same way as the corresponding action characters in z/OS SDSF. The tables that follow show the actions for each of the tables in the SDSF task, and the corresponding action character for z/OS SDSF. For a complete discussion of protecting action characters with SAF, refer to Action characters. With ISFPARMS, action characters are protected with the CMDLEV parameter. Refer to Action characters and overtypeable fields for each command level for more information.

Table 8. Actions on the Unix Processes Table

Action on the Unix Processes Table	Action Character on the PS Panel
Cancel process	C
Display process	D
Kill process	K
Terminate process	T

Table 13. Actions on the CF Structures Table

Action on the CF Structures Table	Action Character on the CFS Panel
Display CF structures	D
Display all CF structures	DA

Table 14. Actions on the Spool Data Sets Table

Action on the Spool Data Sets Table	Action Character on the SP Panel
Display status of spool volumes	D
Display spool in long text	DL
Display spool jobs	J
Purge from spool	P
Purge and cancel all spool files	PC
Start spooling	S
Halt spooling	Z

Table 19. Actions on the Network Activity Table

Action on the Network Activity Table	Action Character on the NA Panel
Display all connection information	DA
Display all format long	DAL
Display byte info	DB
Display byte info format long	DBL
Display connection	DN
Display connection format long	DNL
Display route	DR
Display route detail	DRD
Display route detail format long	DRDL
Display route format long	DRL

Table 20. Actions on the Device Activity Table

Action on the Device Activity Table	Action Character on the DEV Panel
Display unit information	D
Display allocations for the unit	DA
Display IPL volume	DI
Display server path	DSP
Display device server QDASD	DSQD
Display device server Qpath	DSQP
Display device server SMS	DSS
Display vary device online	V
Display vary device offline	VF

Table 21. Actions on the SMS Storage Groups Table

Action on the SMS Storage Groups Table	Action Character on the SMSG Panel
Display SMSG	D
Display volumes in storage group	DL
Disable storage group from allocating or accessing new data sets	VD
Disable storage group from allocating new data sets	VDN
Enable a storage group	VE
Quiesce a storage group	VQ
Quiesce a storage group	VQN
Update space statistics for the storage group	VS

Diagnosing problems in z/OSMF

TSO messages: In addition to z/OSMF messages that are displayed in a message window, TSO messages may be issued in response to starting a session or other interactions. To display these messages, click TSO Messages.

Log files in z/OSMF: The directory of the z/OSMF log file is configurable, as described in IBM z/OS Management Facility Configuration Guide.

Determining the level of the SDSF plug-in: From the z/OSMF Welcome panel, click the About link. Find the IBM SDSF plug-in in the list. The associated information contains the SDSF FMID and the service level of the plug-in.

Removing the SDSF task from z/OSMF

To remove the SDSF and SDSF Settings tasks from z/OSMF, use the Import Manager task to import properties file /usr/lpp/sdsf/zosmf/sdsfDelete.properties.