RPCBIND cataloged procedure

The following sample shows the RPCBIND cataloged procedure.

Figure 1. Sample RPCBIND
//RPCBIND  PROC
//*
//*   TCP/IP FOR MVS
//*   SMP/E DISTRIBUTION NAME: EZARBBND
//*
//*   5694-A01  (C) COPYRIGHT IBM CORP. 2007
//*   LICENSED MATERIALS - PROPERTY OF IBM
//*   THIS PRODUCT CONTAINS "RESTRICTED MATERIALS OF IBM"
//*   ALL RIGHTS RESERVED.
//*   US GOVERNMENT USERS RESTRICTED RIGHTS -
//*   USE, DUPLICATION OR DISCLOSURE RESTRICTED BY
//*   GSA ADP SCHEDULE CONTRACT WITH IBM CORP.
//*   SEE IBM COPYRIGHT INSTRUCTIONS.
//*
//*   FUNCTION: UNIX SYSTEM SERVICES RPCBIND SERVER MAIN PROCESS
//*
//RPCBIND  EXEC PGM=RPCBIND,REGION=4096K,TIME=1440,
//         PARM=('ENVAR("TZ=EST5EDT")/-dl')
//*
//STDOUT   DD SYSOUT=*
//STDERR   DD SYSOUT=*
//SYSOUT   DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//         PEND
You can specify the following options when starting rpcbind:
  • For debug options, you can specify the following -d options to cause rpcbind to send trace information to the daemon facility of syslogd:
    -df
    Sends non-XDR flow information to syslogd.
    -dl
    Sends log information of all RPC procedures called to syslogd.
    -dx
    Sends XDR information to syslogd.
  • The -i option enables you to specify the directory where the pid file should be written:

    Rule: The pid filename is always rpcbind.pid. If -i is not specified, the rpcbind process ID is written to /etc/rpcbind.pid.

  • The -n option enables you to direct rpcbind to run in a nonswappable environment. A process might need to run non-swappable to ensure it is available during periods of high CPU usage. However, a nonswappable process might convert real storage in the system to preferred storage. Because preferred storage cannot be configured offline, running rpcbind in a non-swappable state can reduce your installation's ability to reconfigure storage in the future.

    If you do specify the -n option, ensure that the user ID associated with rpcbind has at least READ access to the resource BPX.STOR.SWAP in the FACILITY class.

    The default is to start rpcbind as swappable.

  • The -s option specifies the number of statistics entries per binding protocol that rpcbind maintains. The allowable range is 113 - 500. Statistics maintained by the rpcbind server are used to reply to the RPCBPROC_GETSTAT request. See RFC 1833 for more information about statistics maintained by the rpcbind server.

    Result: Rpcbind calculates the number of pages needed to store statistics for the value specified and obtains that number of pages of shared memory for statistics. Thus, rpcbind rounds up the number of statistics entries it tracks to fully use the shared memory.

    Tip: Rpcbind does not start unless it can obtain sufficient shared memory to maintain statistics for the number of entries specified. Configure the number of pages of shared memory available to z/OS® with the Start of changeIPCSHMMPAGESEnd of change parameter in the BPXPRMxx member of SYS1.PARMLIB.

  • To display help information, specify the -? option.
Parent topic: RPCBIND