シスコールの出口点の定義

出口ルーチンの管理

動的出口機能を使用して出口ルーチンを管理します。動的出口を管理するには、CSVYDNEX マクロ、SETPROG EXIT コマンド、および SYS1.PARMLIB の PROG parmlib メンバーを使用できます。

出口ルーチン環境

出口ルーチンによるシスコールの拒否

シスコール前の出口ルーチンによって拒否されているシスコールに対する、シスコール後の出口ルーチンは実行されます。呼び出し元の戻りパラメーター (rv/rc/rs) は前述の値に設定され、シスコール後の出口ルーチンで検査のために使用できるようになります。

シスコール前の出口ルーチンは、最後の 3 つのパラメーターが return_value、return_code、および reason_code であるシスコールのみを拒否できます。障害 (BPX1GPI – getpid()) により異常終了するシスコールは拒否できません。シスコール前の出口ルーチンからの戻りコード値は、これらのシスコールにおいては無視されます。

制約事項

1. シスコール出口は、SRB モードの呼び出し元ではサポートされていません。SRB 呼び出し元に対しては、シスコール出口ルーチン (シスコール前またはシスコール後) は呼び出されません。
2. BPX_PRE_SYSCALL および BPX_POST_SYSCALL の各出口点は、それぞれ 5 つの出口ルーチンに制限されます。動的出口機能を使用すると 6 つ以上の出口ルーチンを出口点に追加することができますが、最初の 5 つの出口ルーチンのみが呼び出されます。出口ルーチンが呼び出される順序は動的出口機能によって制御されます。出口ルーチンの呼び出し順序については、「z/OS MVS Programming: Authorized Assembler Services Reference ALE-DYN」の CSVDYNEX のセクションを参照してください。
3. シスコール出口ルーチンからの、以下の z/OS UNIX 呼び出し可能サービスの使用は許可されていません。z/OS UNIX では、呼び出し元環境が原因で、シスコール出口ルーチンの実行中に以下の呼び出し可能サービスがシステムに悪影響を及ぼすおそれがあると判断しました。これらの呼び出し可能サービスがシスコール出口ルーチンから呼び出された場合、失敗します。シスコールが戻り値 -1 または 0 で失敗する場合、戻りコードは EMVSERR に設定され、理由コードは JrSyscallExit に設定されます。シスコールがエラーで異常終了する場合、完了コード EC6、理由コード 'xxxxC056'x で異常終了します。

   表 5. シスコール出口ルーチンから使用できない呼び出し可能サービス

   シスコール名	スタブ名	シスコール名	スタブ名
   istty()	BPX1ITY	cond_timed_wait()	BPX1CTW、BPX4CTW
   ttyname()	BPX1TYN	cond_wait()	BPX1CWA、BPX4CWA
   tcflush()	BPX1TFH、BPX4TFH	MVSpauseinit()	BPX1MPI
   tcdrain()	BPX1TDR、BPX4TDR	MVSpause()	BPX1MP、BPX4MP
   tcflow()	BPX1TFW、BPX4TFW	nice()	BPX1NIC、BPX4NIC
   tcgetattr()	BPX1TGA、BPX4TGA	getitimer()	BPX1GTR、BPX4GTR
   tcgetpgrp()	BPX1TGP、BPX4TGP	setitimer()	BPX1STR、BPX4STR
   tcsetattr()	BPX1TSA、BPX4TSA	spawn()	BPX1SPN、BPX4SPN
   tcsendbreak()	BPX1TSB、BPX4TSB	chpriority()	BPX1CHP
   tcsetpgrp()	BPX1TSP、BPX4TSP	password()	BPX1SGE、BPX4SGE
   alarm()	BPX1ALR、BPX4ALR	setgroups()	BPX1SPE、BPX4SPE
   exec()	BPX1EXC、BPX4EXC	mmap()	BPX1PWD、BPX4PWD
   exit()	BPX1EXI、BPX4EXI	mprotect()	BPX1SGR、BPX4SGR
   execmvs()	BPX1EXM、BPX4EXM	msync()	BPX1MMP、BPX4MMP
   fork()	BPX1FRK、BPX4FRK	munmap()	BPX1MPR、BPX4MPR
   setdubdefault()	BPX1SDD、BPX4SDD	waitid()/wait3()	BPX1MSY
   mvssigsetup()	BPX1MSS、BPX4MSS	loadhfs()	BPX1MUM
   pause()	BPX1PAS、BPX4PAS	deletehfs()	BPX1WTE、BPX4WTE
   ptrace()	BPX1PTR、BPX4PTR	setreuid()	BPX1LOD、BPX4LOD
   sigaction()	BPX1SIA、BPX4SIA	setregid()	BPX1DEL、BPX4DEL
   setgid()	BPX1SGI、BPX4SGI	pthread_security_np()	BPX1SRU、BPX4SRU
   mvsunsigsetup()	BPX1MSD、BPX4MSD	convert_id_np()	BPX1SRG、BPX4SRG
   sigpending()	BPX1SIP、BPX4SIP	auth_check_rsrc_np()	BPX1TLS、BPX4TLS
   sleep()	BPX1SLP、BPX4SLP	server_init()	BPX1CID、BPX4CID
   setpgid()	BPX1SPG、BPX4SPG	server_pwu()	BPX1ACK、BPX4ACK
   sigprocmask()	BPX1SPM、BPX4SPM	__security()	BPX1SIN、BPX4SIN
   setsid()	BPX1SSI、BPX4SSI	__wlm()	BPX1SPW、BPX4SPW
   sigsuspend()	BPX1SSU、BPX4SSU	send_filePC-only()	BPX1SEC、BPX4SEC
   setuid()	BPX1SUI、BPX4SUI	__shm_lock()	BPX1WLM、BPX4WLM
   wait()	BPX1WAT、BPX4WAT	__pid_affinity()	BPX1SF、BPX4SF
   quiesce()	BPX1QSE、BPX4QSE	set_timer_event()	BPX1SLK、BPX4SLK
   unquiesce()	BPX1UQS、BPX4UQS	srx_np	BPX1PAF、BPX4PAF
   MVSIptAffinity	BPX1IPT、BPX4IPT	__sigactionset()	BPX1STE、BPX4STE
   mvsprocclp()	BPX1MPC、BPX4MPC	aio_suspend()	BPX1SRX、BPX4SRX
   pthread_quiesce()	BPX1PTQ、BPX4PTQ	sigtimedwait()	BPX1SA2、BPX4SA2
   sigputback()	BPX1SPB、BPX4SPB	__osenv()	BPX1ASP、BPX4ASP
   seteuid()	BPX1SEU、BPX4SEU	__map_init()	BPX1STW、BPX4STW
   setegid()	BPX1SEG、BPX4SEG	__map_service()	BPX1OSE、BPX4OSE
   w_getpsent()	BPX1GPS、BPX4GPS	MvsThreadAffinity()	BPX1MMI、BPX4MMI
   pthread_xandg()	BPX1PTX、BPX4PTX	pthread_quiesce _and_get_np()	BPX1MMS、BPX4MMS
   sigwait()	BPX1SWT、BPX4SWT	__poe()	BPX1TAF、BPX4TAF
   pthread_setintrtype()	BPX1PST、BPX4PST	extended_loadhfs()	BPX1PQG、BPX4PQG
   pthread_testintr()	BPX1PSI、BPX4PSI		BPX1POE、BPX4POE
   cond_cancel()	BPX1CCA、BPX4CCA		BPX1LDX、BPX4LDX
   cond_setup()	BPX1CSE、BPX4CSE

使用上の注意